StructureDefinition
for
dateTime
Base StructureDefinition for dateTime Type: A date, date-time or partial date (e.g. just
year or year + month). If hours and minutes are specified, a time zone SHALL be populated.
The format is a union of the schema types gYear, gYearMonth, date and dateTime. Seconds
must be provided due to schema type constraints but may be zero-filled and may be ignored.
Dates SHALL be valid dates.
A date, date-time or partial date (e.g. just year or year + month). If hours and minutes
are specified, a time zone SHALL be populated. The format is a union of the schema types
gYear, gYearMonth, date and dateTime. Seconds must be provided due to schema type constraints
but may be zero-filled and may be ignored. Dates SHALL be valid dates.
<?xml version="1.0" encoding="UTF-8"?>
<StructureDefinition xmlns="http://hl7.org/fhir"> <id value="dateTime"/> <text> <status value="generated"/> <div xmlns="http://www.w3.org/1999/xhtml">to do</div> </text> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status"> <valueCode value="normative"/> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version"> <valueCode value="4.0.0"/> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics"> <valueCode value="has-range"/> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics"> <valueCode value="is-continuous"/> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics"> <valueCode value="has-length"/> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg"> <valueCode value="fhir"/> </extension> <url value="http://hl7.org/fhir/StructureDefinition/dateTime"/> <version value="6.0.0-ballot3"/> <name value="dateTime"/> <status value="active"/> <experimental value="false"/> <date value="2025-12-17T09:50:17+00:00"/> <publisher value="HL7 International / FHIR Infrastructure"/> <contact> <telecom> <system value="url"/> <value value="http://hl7.org/fhir"/> </telecom> </contact> <contact> <telecom> <system value="url"/> <value value="http://www.hl7.org/Special/committees/fiwg"/> </telecom> </contact> <description value="dateTime Type: A date, date-time or partial date (e.g. just year or year + month).
If hours and minutes are specified, a UTC offset SHALL be populated. The format
is a union of the schema types gYear, gYearMonth, date and dateTime. Seconds must
be provided due to schema type constraints but may be zero-filled and may be ignored.
Dates SHALL be valid dates."/>
<jurisdiction> <coding> <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/> <code value="001"/> <display value="World"/> </coding> </jurisdiction> <fhirVersion value="6.0.0-ballot3"/> <kind value="primitive-type"/> <abstract value="false"/> <type value="dateTime"/> <baseDefinition value="http://hl7.org/fhir/StructureDefinition/PrimitiveType"/> <derivation value="specialization"/> <snapshot> <element id="dateTime"> <path value="dateTime"/> <short value="Primitive Type dateTime"/> <definition value="A date, date-time or partial date (e.g. just year or year + month). If hours and
minutes are specified, a UTC offset SHALL be populated. The format is a union of
the schema types gYear, gYearMonth, date and dateTime. Seconds must be provided
due to schema type constraints but may be zero-filled and may be ignored.
Dates SHALL be valid dates."/>
<comment value="UTC offset is allowed for dates and partial dates"/> <min value="0"/> <max value="*"/> <base> <path value="dateTime"/> <min value="0"/> <max value="*"/> </base> <constraint> <key value="ele-1"/> <severity value="error"/> <human value="All FHIR elements must have a @value or children or both"/> <expression value="hasValue() or (children().count() > id.count())"/> <source value="http://hl7.org/fhir/StructureDefinition/Element"/> </constraint> <isModifier value="false"/> <isSummary value="false"/> </element> <element id="dateTime.id"> <path value="dateTime.id"/> <representation value="xmlAttr"/> <short value="xml:id (or equivalent in JSON)"/> <definition value="unique id for the element within a resource (for internal references)"/> <min value="0"/> <max value="1"/> <base> <path value="Element.id"/> <min value="0"/> <max value="1"/> </base> <type> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type"> <valueUrl value="string"/> </extension> <code value="http://hl7.org/fhirpath/System.String"/> </type> <isModifier value="false"/> <isSummary value="false"/> </element> <element id="dateTime.extension"> <path value="dateTime.extension"/> <short value="Additional content defined by implementations"/>
<definition value="May be used to represent additional information that is not part of the basic definition
of the resource. In order to make the use of extensions safe and manageable, there is
a strict set of governance applied to the definition and use of extensions. Though any
implementer is allowed to define an extension, there is a set of requirements that SHALL
be met as part of the definition of the extension.
There can be no stigma associated with the use of extensions by any application, project,
or standard - regardless of the institution or jurisdiction that uses or defines the extensions.
The use of extensions is what allows the FHIR specification to retain a core level of
simplicity for everyone.
<!-- Note: primitive values do not have an assigned type. e.g. this is compiler magic. XML,
JSON and RDF types provided by extension -->
-?[0-9]{4}(-(0[1-9]|1[0-2])(-(0[0-9]|[1-2][0-9]|3[0-1])(T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.
[0-9]+)?(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00)))?)?)?
A date, date-time or partial date (e.g. just year or year + month). If hours and minutes
are specified, a time zone SHALL be populated. The format is a union of the schema types
gYear, gYearMonth, date and dateTime. Seconds must be provided due to schema type constraints
but may be zero-filled and may be ignored. Dates SHALL be valid dates.
<!-- Note: primitive values do not have an assigned type. e.g. this is compiler magic. XML,
JSON and RDF types provided by extension -->
-?[0-9]{4}(-(0[1-9]|1[0-2])(-(0[0-9]|[1-2][0-9]|3[0-1])(T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.
[0-9]+)?(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00)))?)?)?
of the resource. To make the use of extensions safe and managable, there is a strict
set of governance applied to the definition and use of extensions. Though any implementer
can define an extension, there is a set of requirements that SHALL be met as part
of the definition of the extension."/>
<comment value="There can be no stigma associated with the use of extensions by any application,
project, or standard - regardless of the institution or jurisdiction that uses
or defines the extensions. The use of extensions is what allows the FHIR specification
to retain a core level of simplicity for everyone."/>
<alias value="extensions"/> <alias value="user content"/> <min value="0"/> <max value="*"/> <base> <path value="Element.extension"/> <min value="0"/> <max value="*"/> </base> <type> <code value="Extension"/> </type> <constraint> <key value="ele-1"/> <severity value="error"/> <human value="All FHIR elements must have a @value or children"/> <expression value="hasValue() or (children().count() > id.count())"/> <source value="http://hl7.org/fhir/StructureDefinition/Element"/> </constraint> <constraint> <key value="ext-1"/> <severity value="error"/> <human value="Must have either extensions or value[x], not both"/> <expression value="extension.exists() != value.exists()"/> <source value="http://hl7.org/fhir/StructureDefinition/Extension"/> </constraint> <isModifier value="false"/> <isSummary value="false"/> </element> <element id="dateTime.value"> <path value="dateTime.value"/> <representation value="xmlAttr"/> <short value="Primitive value for dateTime"/> <definition value="The actual value"/> <min value="0"/> <max value="1"/> <base> <path value="dateTime.value"/> <min value="0"/> <max value="1"/> </base>
<type> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type"> <valueUrl value="dateTime"/> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/regex"> <valueString value="([0-9]([0-9]([0-9][1-9]|[1-9]0)|[1-9]00)|[1-9]000)(-(0[1-9]|1[0-2])(-(0[1-9]|[1-2][0-9]|3[0-1
])(T([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)(\.[0-9]{1,9})?(Z|(\+|-)((0[0-9]|1[0-3]):[0-5
][0-9]|14:00)?)?)?)?)?"/>
</extension> <code value="http://hl7.org/fhirpath/System.DateTime"/> </type> <isModifier value="false"/> <isSummary value="false"/> </element> </snapshot> <differential> <element id="dateTime"> <path value="dateTime"/> <short value="Primitive Type dateTime"/> <definition value="A date, date-time or partial date (e.g. just year or year + month). If hours and
minutes are specified, a UTC offset SHALL be populated. The format is a union of
the schema types gYear, gYearMonth, date and dateTime. Seconds must be provided
due to schema type constraints but may be zero-filled and may be ignored.
Dates SHALL be valid dates."/>
<comment value="UTC offset is allowed for dates and partial dates"/> <min value="0"/> <max value="*"/> </element> <element id="dateTime.value"> <path value="dateTime.value"/> <representation value="xmlAttr"/> <short value="Primitive value for dateTime"/> <definition value="Primitive value for dateTime"/> <min value="0"/> <max value="1"/>
<type> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type"> <valueUrl value="dateTime"/> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/regex"> <valueString value="([0-9]([0-9]([0-9][1-9]|[1-9]0)|[1-9]00)|[1-9]000)(-(0[1-9]|1[0-2])(-(0[1-9]|[1-2][0-9]|3[0-1
])(T([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)(\.[0-9]{1,9})?(Z|(\+|-)((0[0-9]|1[0-3]):[0-5
][0-9]|14:00)?)?)?)?)?"/>
</extension> <code value="http://hl7.org/fhirpath/System.DateTime"/> </type> </element> </differential>
</
StructureDefinition
>
Usage
note:
every
effort
has
been
made
to
ensure
that
the
examples
are
correct
and
useful,
but
they
are
not
a
normative
part
of
the
specification.