Consolidated CDA (C-CDA), published by Health Level Seven. This guide is not an authorized publication; it is the continuous build for version 4.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-ccda/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/cda/us/ccda/StructureDefinition/USRealmDateTime | Version: 4.0.0 | |||
| Draft as of 2025-10-31 | Computable Name: USRealmDateTime | |||
| Other Identifiers: OID:2.16.840.1.113883.10.20.22.5.4 | ||||
The US Realm Clinical Document Date and Time datatype flavor records date and time information. If time is provided, it must include a time zone offset.
This data type uses the same rules as US Realm Date and Time (Interval), but is used with elements having a datatype of TS.
Usages:
You can also check for usages in the FHIR IG Statistics
Changes since version 3.0.0:
Description of Template, Differentials, Snapshots and how the different presentations work.
This structure is derived from TS
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 1..* | TS | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: ts-shall-day, ts-should-minute |
![]() ![]() |
0..1 | ts | Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz] | |
Documentation for this format | ||||
| Id | Grade | Path(s) | Description | Expression |
| ts-shall-day | error | TS | **SHALL** be precise to at least the day |
nullFlavor.exists() or value.toString().length() >= 10
|
| ts-should-minute | warning | TS | **SHOULD** be precise to at least the minute |
nullFlavor.exists() or value.toString().length() > 10
|
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 1..* | TS | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: ts-shall-day, ts-should-minute |
![]() ![]() |
0..1 | cs | Binding: CDANullFlavor (required) | |
![]() ![]() |
0..1 | ts | Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz] | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| TS.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Id | Grade | Path(s) | Description | Expression |
| ts-shall-day | error | TS | **SHALL** be precise to at least the day |
nullFlavor.exists() or value.toString().length() >= 10
|
| ts-should-minute | warning | TS | **SHOULD** be precise to at least the minute |
nullFlavor.exists() or value.toString().length() > 10
|
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 1..* | TS | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: ts-shall-day, ts-should-minute |
![]() ![]() |
0..1 | cs | Binding: CDANullFlavor (required) | |
![]() ![]() |
0..1 | ts | Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz] | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| TS.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Id | Grade | Path(s) | Description | Expression |
| ts-shall-day | error | TS | **SHALL** be precise to at least the day |
nullFlavor.exists() or value.toString().length() >= 10
|
| ts-should-minute | warning | TS | **SHOULD** be precise to at least the minute |
nullFlavor.exists() or value.toString().length() > 10
|
This structure is derived from TS
Differential View
This structure is derived from TS
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 1..* | TS | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: ts-shall-day, ts-should-minute |
![]() ![]() |
0..1 | ts | Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz] | |
Documentation for this format | ||||
| Id | Grade | Path(s) | Description | Expression |
| ts-shall-day | error | TS | **SHALL** be precise to at least the day |
nullFlavor.exists() or value.toString().length() >= 10
|
| ts-should-minute | warning | TS | **SHOULD** be precise to at least the minute |
nullFlavor.exists() or value.toString().length() > 10
|
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 1..* | TS | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: ts-shall-day, ts-should-minute |
![]() ![]() |
0..1 | cs | Binding: CDANullFlavor (required) | |
![]() ![]() |
0..1 | ts | Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz] | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| TS.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Id | Grade | Path(s) | Description | Expression |
| ts-shall-day | error | TS | **SHALL** be precise to at least the day |
nullFlavor.exists() or value.toString().length() >= 10
|
| ts-should-minute | warning | TS | **SHOULD** be precise to at least the minute |
nullFlavor.exists() or value.toString().length() > 10
|
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 1..* | TS | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: ts-shall-day, ts-should-minute |
![]() ![]() |
0..1 | cs | Binding: CDANullFlavor (required) | |
![]() ![]() |
0..1 | ts | Date Format: YYYYMMDDHHMMSS.UUUU[+|-ZZzz] | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| TS.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Id | Grade | Path(s) | Description | Expression |
| ts-shall-day | error | TS | **SHALL** be precise to at least the day |
nullFlavor.exists() or value.toString().length() >= 10
|
| ts-should-minute | warning | TS | **SHOULD** be precise to at least the minute |
nullFlavor.exists() or value.toString().length() > 10
|
This structure is derived from TS