Release 5 Draft Ballot

This page is part of the FHIR Specification (v4.6.0: R5 Draft Ballot). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

Datetime.profile.xml

Modeling and Methodology Work GroupMaturity Level: N/AStandards Status: Informative

Raw XML (canonical form + also see XML Format Specification)

StructureDefinition for dateTime

<?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> 
  <url value="http://hl7.org/fhir/StructureDefinition/dateTime"/> 
  <version value="4.6.0"/> 
  <name value="dateTime"/> 
  <status value="active"/> 
  <date value="2021-04-15T12:25:09+10:00"/> 
  <publisher value="HL7 FHIR Standard"/> 
  <contact> 
    <telecom> 
      <system value="url"/> 
      <value value="http://hl7.org/fhir"/> 
    </telecom> 
  </contact> 
  <description value="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 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."/> 
  <fhirVersion value="4.6.0"/> 
  <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."/> 
      <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"/> 
        <expression value="hasValue() or (children().count() &gt; id.count())"/> 
        <xpath value="@value|f:*|h:div"/> 
        <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">
          <valueUri 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. 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
       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() &gt; id.count())"/> 
        <xpath value="@value|f:*|h:div"/> 
        <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()"/> 
        <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])"/> 
        <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> 
    <!--  Note: special primitive values have a FHIRPath system type. e.g. this is compiler magic
       (c)  -->
      <type> 
        <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
          <valueUri 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([0
          1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)(\.[0-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."/> 
      <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"/> 
    <!--  Note: special primitive values have a FHIRPath system type. e.g. this is compiler magic
       (a)  -->
    <!--  Note: special primitive values have a FHIRPath system type. e.g. this is compiler magic
       (b)  -->
      <type> 
        <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
          <valueUri 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([0
          1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)(\.[0-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.