{
  "resourceType": "CodeSystem",
  "id": "version-algorithm",
  "meta": {
    "lastUpdated": "2026-05-20T15:02:53.575+00:00"
  },
  "text": {
    "status": "generated",
    "div": "\u003cdiv xmlns\u003d\"http://www.w3.org/1999/xhtml\"\u003e\u003cp class\u003d\"res-header-id\"\u003e\u003cb\u003eGenerated Narrative: CodeSystem version-algorithm\u003c/b\u003e\u003c/p\u003e\u003ca name\u003d\"version-algorithm\"\u003e \u003c/a\u003e\u003ca name\u003d\"hcversion-algorithm\"\u003e \u003c/a\u003e\u003cp\u003eThis case-sensitive code system \u003ccode\u003ehttp://hl7.org/fhir/version-algorithm\u003c/code\u003e defines the following codes:\u003c/p\u003e\u003ctable class\u003d\"codes\"\u003e\u003ctr\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003e\u003cb\u003eCode\u003c/b\u003e\u003c/td\u003e\u003ctd\u003e\u003cb\u003eDisplay\u003c/b\u003e\u003c/td\u003e\u003ctd\u003e\u003cb\u003eDefinition\u003c/b\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003esemver\u003ca name\u003d\"version-algorithm-semver\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eSemVer\u003c/td\u003e\u003ctd\u003e\u003cdiv\u003e\u003cp\u003eUses the semantic versioning scheme as defined in \u003ca href\u003d\"http://semver.org\"\u003esemver.org\u003c/a\u003e.\u003c/p\u003e\n\u003c/div\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003einteger\u003ca name\u003d\"version-algorithm-integer\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eInteger\u003c/td\u003e\u003ctd\u003e\u003cdiv\u003e\u003cp\u003eVersions are integers and ordered numerically\u003c/p\u003e\n\u003c/div\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003ealpha\u003ca name\u003d\"version-algorithm-alpha\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eAlphabetical\u003c/td\u003e\u003ctd\u003e\u003cdiv\u003e\u003cp\u003eSimple alphabetic sort on a case-insensitive and accent-insensitive basis.  (Sorting of different cases or accented versions of a character is indeterminate)\u003c/p\u003e\n\u003c/div\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003edate\u003ca name\u003d\"version-algorithm-date\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eDate\u003c/td\u003e\u003ctd\u003e\u003cdiv\u003e\u003cp\u003eVersions 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.\u003c/p\u003e\n\u003c/div\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003enatural\u003ca name\u003d\"version-algorithm-natural\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eNatural\u003c/td\u003e\u003ctd\u003e\u003cdiv\u003e\u003cp\u003eSorted according to the algorithm defined here: \u003ca href\u003d\"http://www.naturalordersort.org/\"\u003enaturalordersort.org\u003c/a\u003e\u003c/p\u003e\n\u003c/div\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003emajor-minor\u003ca name\u003d\"version-algorithm-major-minor\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eMajor/Minor\u003c/td\u003e\u003ctd\u003e\u003cdiv\u003e\u003cp\u003eSimilar to semver, but having only two components - i.e. a major and minor (integer) version number separated by a \u0027.\u0027.  The specific nature of what constitutes a major vs. minor increment is locally defined.\u003c/p\u003e\n\u003c/div\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003esct-url\u003ca name\u003d\"version-algorithm-sct-url\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eSNOMED-CT URL\u003c/td\u003e\u003ctd\u003e\u003cdiv\u003e\u003cp\u003eVersions are expressed according to the SNOMED URL scheme. See the \u003ca href\u003d\"https://terminology.hl7.org/SNOMEDCT.html#versions\"\u003eVersions\u003c/a\u003e topic for more details.\u003c/p\u003e\n\u003c/div\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003eus-date\u003ca name\u003d\"version-algorithm-us-date\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eUS Date\u003c/td\u003e\u003ctd\u003e\u003cdiv\u003e\u003cp\u003eVersions are expressed as an US date format, i.e. MMDDYYYY (with or without separators).\u003c/p\u003e\n\u003c/div\u003e\u003c/td\u003e\u003c/tr\u003e\u003c/table\u003e\u003c/div\u003e"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "cds"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "normative"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 5
    }
  ],
  "url": "http://hl7.org/fhir/version-algorithm",
  "identifier": [
    {
      "system": "urn:ietf:rfc:3986",
      "value": "urn:oid:2.16.840.1.113883.4.642.4.1989"
    }
  ],
  "version": "6.0.0-ballot4",
  "name": "VersionAlgorithm",
  "title": "Version Algorithm",
  "status": "active",
  "experimental": false,
  "date": "2021-01-05T10:01:24+11:00",
  "publisher": "HL7 International / Clinical Decision Support",
  "contact": [
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://hl7.org/fhir"
        },
        {
          "system": "email",
          "value": "fhir@lists.hl7.org"
        }
      ]
    },
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/dss"
        }
      ]
    }
  ],
  "description": "Indicates the mechanism used to compare versions to determine which is more current.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "caseSensitive": true,
  "valueSet": "http://hl7.org/fhir/ValueSet/version-algorithm",
  "content": "complete",
  "concept": [
    {
      "code": "semver",
      "display": "SemVer",
      "definition": "Uses the semantic versioning scheme as defined in [semver.org](http://semver.org)."
    },
    {
      "code": "integer",
      "display": "Integer",
      "definition": "Versions are integers and ordered numerically"
    },
    {
      "code": "alpha",
      "display": "Alphabetical",
      "definition": "Simple alphabetic sort on a case-insensitive and accent-insensitive basis.  (Sorting of different cases or accented versions of a character is indeterminate)"
    },
    {
      "code": "date",
      "display": "Date",
      "definition": "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."
    },
    {
      "code": "natural",
      "display": "Natural",
      "definition": "Sorted according to the algorithm defined here: [naturalordersort.org](http://www.naturalordersort.org/)"
    },
    {
      "code": "major-minor",
      "display": "Major/Minor",
      "definition": "Similar to semver, but having only two components - i.e. a major and minor (integer) version number separated by a \u0027.\u0027.  The specific nature of what constitutes a major vs. minor increment is locally defined."
    },
    {
      "code": "sct-url",
      "display": "SNOMED-CT URL",
      "definition": "Versions are expressed according to the SNOMED URL scheme. See the [Versions](https://terminology.hl7.org/SNOMEDCT.html#versions) topic for more details."
    },
    {
      "code": "us-date",
      "display": "US Date",
      "definition": "Versions are expressed as an US date format, i.e. MMDDYYYY (with or without separators)."
    }
  ]
}