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

<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="version-algorithm"/>
  <meta>
    <lastUpdated value="2026-03-16T22:59:53.445+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-ballot4"/>
  <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)"/>
  </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) 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.naturalordersort.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://terminology.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>