Release 4B 5

This page is part of the FHIR Specification (v4.3.0: R4B (v5.0.0: R5 - STU ). The This is the current published version which supercedes in it's permanent home (it will always be available at this version is 5.0.0 . URL). For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R5 R4B R4 R3 R2

Datetime.profile.xml

Example StructureDefinition/dateTime (XML)

Modeling and Methodology Work Group Maturity Level : N/A Standards Status : Informative

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

StructureDefinition for dateTime

<?xml version="1.0" encoding="UTF-8"?>


  
  
    
    
  
  
    
  
  
    
  
  
  
  
  
  
  
  
  
    
      
      
    
  
  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.
      
      
      
        
        
        
      
      
        
        
        
        
        
        
      
      
      
    
    
      
      
      
      
      
      
      
        
        
        
      
      
        
          
        
        
      
      
      
    
    
      
      

<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> 
  <url value="http://hl7.org/fhir/StructureDefinition/dateTime"/> 
  <version value="5.0.0"/> 
  <name value="dateTime"/> 
  <status value="active"/> 
  <experimental value="false"/> 
  <date value="2023-03-26T15:21:02+11:00"/> 
  <publisher value="HL7 FHIR Standard"/> 
  <contact> 
    <telecom> 
      <system value="url"/> 
      <value value="http://hl7.org/fhir"/> 
    </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="5.0.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."/> 
      <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"/>         <expression value="hasValue() or (children().count() &gt; 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. 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.
      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.
      
      
      
      
      
        
        
        
      
      
        
      
      
        
        
        
        
        
        
      
      
        
        
        
        
        
        
      
      
      
    
    
      
      
      
      
      
      
      
        
        
        
      
      
        
          
        
        
          ([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)))?)?
          )?
        
        
      
      
      
    
  
  
    
      
      
      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.
      
      
    
    
      
      
      
      
      
      
      
        
          
        
        
          ([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)))?)?
          )?
        
        
      
    
  

       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() &gt; 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>       <!--  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">          <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"/>       <!--  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">          <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.