Release 5 FHIR CI-Build

This page is part of the Continuous Integration Build of FHIR Specification (v5.0.0: R5 - STU ). This is the current published version in it's permanent home (it will always (will be available incorrect/inconsistent at this URL). For a full list of available versions, see times).
See the Directory of published versions

Example CodeSystem/version-algorithm (XML)

Maturity Level : N/A
FHIR Infrastructure Responsible Owner: Clinical Decision Support Work Group Standards Status : Informative

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

Definition for Code SystemVersionAlgorithm

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


  
  
    
    
  
  
    
    
      This code system 
         defines the following codes:
      
      
        
          
            
          
          
            
          
          
            
          
        
        
          semver
            
          
          
          
        
        
          integer
            
          
          
          
        
        
          alpha
            
          
          
          Simple alphabetic sort on a case-insensitive and accent-insensitive basis.  (Sorting
             of different cases or accented versions of a character is indeterminate)
        
        
          date
            
          
          
          Versions are expressed as an ISO date/time syntax (including syntaxes with only
             portions of a date)
        
        
          natural
            
          
          
          Sorted according to the algorithm defined here: [naturalordersort.org](http://www.naturalorde
            rsort.org/)
        
      
    
  
  
    
  
  
    
  
  
    
  
  
  
    
    
  
  
  
  
  
  
  
  
  
    
      
      
    
    
      
      
    
  
  
  
    
      
      
      
    
  
  
  
  
  
    
    
    
  
  
    
    
    
  
  
    
    

<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="version-algorithm"/> 
  <meta> 
    <lastUpdated value="2025-11-27T16:48:47.349+00:00"/> 
  </meta> 
  <text> 
    <status value="generated"/> 
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p class="res-header-id">
        <b> Generated Narrative: CodeSystem version-algorithm</b> 
      </p> 
      <a name="version-algorithm"> </a> 
      <a name="hcversion-algorithm"> </a> 
      <p> This case-sensitive code system 
        <code> http://hl7.org/fhir/version-algorithm</code>  defines the following codes:
      </p> 
      <table class="codes">
        <tr> 
          <td style="white-space:nowrap">
            <b> Code</b> 
          </td> 
          <td> 
            <b> Display</b> 
          </td> 
          <td> 
            <b> Definition</b> 
          </td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">semver
            <a name="version-algorithm-semver"> </a> 
          </td> 
          <td> SemVer</td> 
          <td> 
            <div> 
              <p> Uses the semantic versioning scheme as defined in 
                <a href="http://semver.org">semver.org</a> .
              </p> 
            </div> 
          </td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">integer
            <a name="version-algorithm-integer"> </a> 
          </td> 
          <td> Integer</td> 
          <td> 
            <div> 
              <p> Versions are integers and ordered numerically</p> 
            </div> 
          </td> 
        </tr> 
        <tr> 
          <td style="white-space:nowrap">alpha
            <a name="version-algorithm-alpha"> </a> 
          </td> 
          <td> Alphabetical</td> 
          <td> 
            <div> 
              <p> Simple alphabetic sort on a case-insensitive and accent-insensitive basis.  (Sorting
                 of different cases or accented versions of a character is indeterminate)</p> 
            </div>           </td>         </tr>         <tr>           <td style="white-space:nowrap">date            <a name="version-algorithm-date"> </a>           </td>           <td> Date</td>           <td>             <div>               <p> Versions are expressed as an ISO date/time syntax (including syntaxes with only

                 portions of a date) in the general format of YYYY-MM-DD (with or without separators).
                 Inclusion of the time portion is optional.</p> 
            </div>           </td>         </tr>         <tr>           <td style="white-space:nowrap">natural            <a name="version-algorithm-natural"> </a>           </td>           <td> Natural</td>           <td>             <div>               <p> Sorted according to the algorithm defined here:                 <a href="http://www.naturalordersort.org/">naturalordersort.org</a>               </p>             </div>           </td>         </tr>         <tr>           <td style="white-space:nowrap">major-minor            <a name="version-algorithm-major-minor"> </a>           </td>           <td> Major/Minor</td>           <td>             <div>               <p> Similar to semver, but having only two components - i.e. a major and minor (integer)

                 version number separated by a '.'.  The specific nature of what constitutes a major
                 vs. minor increment is locally defined.</p> 
            </div>           </td>         </tr>         <tr>           <td style="white-space:nowrap">sct-url            <a name="version-algorithm-sct-url"> </a>           </td>           <td> SNOMED-CT URL</td>           <td>             <div>               <p> Versions are expressed according to the SNOMED URL scheme. See the                 <a href="https://terminology.hl7.org/SNOMEDCT.html#versions">Versions</a>  topic for more details.              </p>             </div>           </td>         </tr>         <tr>           <td style="white-space:nowrap">us-date            <a name="version-algorithm-us-date"> </a>           </td>           <td> US Date</td>           <td>             <div>               <p> Versions are expressed as an US date format, i.e. MMDDYYYY (with or without separators).</p>             </div>           </td>         </tr>       </table>     </div>   </text>   <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">    <valueCode value="cds"/>   </extension>   <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">    <valueCode value="normative"/>   </extension>   <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">    <valueInteger value="5"/>   </extension>   <url value="http://hl7.org/fhir/version-algorithm"/>   <identifier>     <system value="urn:ietf:rfc:3986"/>     <value value="urn:oid:2.16.840.1.113883.4.642.4.1989"/>   </identifier>   <version value="6.0.0-ballot3"/>   <name value="VersionAlgorithm"/>   <title value="Version Algorithm"/>   <status value="active"/>   <experimental value="false"/>   <date value="2021-01-05T10:01:24+11:00"/>   <publisher value="HL7 International / Clinical Decision Support"/>   <contact>     <telecom>       <system value="url"/>       <value value="http://hl7.org/fhir"/>     </telecom>     <telecom>       <system value="email"/>       <value value="fhir@lists.hl7.org"/>     </telecom>   </contact>   <contact>     <telecom>       <system value="url"/>       <value value="http://www.hl7.org/Special/committees/dss"/>     </telecom>   </contact>   <description value="Indicates the mechanism used to compare versions to determine which is more current."/>   <jurisdiction>     <coding>       <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>       <code value="001"/>       <display value="World"/>     </coding>   </jurisdiction>   <caseSensitive value="true"/>   <valueSet value="http://hl7.org/fhir/ValueSet/version-algorithm"/>   <content value="complete"/>   <concept>     <code value="semver"/>     <display value="SemVer"/>     <definition value="Uses the semantic versioning scheme as defined in [semver.org](http://semver.org)."/>   </concept>   <concept>     <code value="integer"/>     <display value="Integer"/>     <definition value="Versions are integers and ordered numerically"/>   </concept>   <concept>     <code value="alpha"/>     <display value="Alphabetical"/> 
    <definition value="Simple alphabetic sort on a case-insensitive and accent-insensitive basis.  (Sorting
     of different cases or accented versions of a character is indeterminate)
  
  
    
    

     of different cases or accented versions of a character is indeterminate)"/> 
  </concept>   <concept>     <code value="date"/>     <display value="Date"/> 
    <definition value="Versions are expressed as an ISO date/time syntax (including syntaxes with only
     portions of a date)
  
  
    
    

     portions of a date) in the general format of YYYY-MM-DD (with or without separators).
     Inclusion of the time portion is optional."/> 
  </concept>   <concept>     <code value="natural"/>     <display value="Natural"/> 
    <definition value="Sorted according to the algorithm defined here: [naturalordersort.org](http://www.naturalorde
    rsort.org/)
  

    rsort.org/)"/> 
  </concept>   <concept>     <code value="major-minor"/>     <display value="Major/Minor"/>     <definition value="Similar to semver, but having only two components - i.e. a major and minor (integer)

     version number separated by a '.'.  The specific nature of what constitutes a major
     vs. minor increment is locally defined."/> 
  </concept>   <concept>     <code value="sct-url"/>     <display value="SNOMED-CT URL"/>     <definition value="Versions are expressed according to the SNOMED URL scheme. See the [Versions](https://termino

    logy.hl7.org/SNOMEDCT.html#versions) topic for more details."/> 
  </concept>   <concept>     <code value="us-date"/>     <display value="US Date"/>     <definition value="Versions are expressed as an US date format, i.e. MMDDYYYY (with or without separators)."/>   </concept> 


</

CodeSystem

>



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.