{
  "package-id" : "hl7.fhirpath",
  "title" : "FHIRPath Specification",
  "canonical" : "http://hl7.org/fhirpath",
  "category" : "infrastructure",
  "list" : [{
    "version" : "current",
    "date" : "n/a",
    "descmd" : "Continuous Integration Build (latest in version control)",
    "path" : "https://build.fhir.org/ig/HL7/FHIRPath",
    "status" : "ci-build",
    "current" : true
  },
  {
    "version" : "3.0.0",
    "path" : "http://hl7.org/fhirpath/STU3",
    "status" : "trial-use",
    "sequence" : "R3",
    "fhirversion" : "4.0.1",
    "date" : "2026-07-28",
    "current" : true,
    "desc" : "First milestone STU release of FHIRPath since normative publication, containing implementer feedback and additional functions and capabilities, as well as clarifications and corrections throughout. Additions have been clearly marked as STU.",
    "descmd" : "First milestone STU release of FHIRPath since normative publication, containing implementer feedback and additional functions and capabilities, as well as clarifications and corrections throughout. Additions have been clearly marked as STU.\n\nHighlights include:\n* Added new functions: `coalesce()`, `sort()`, `repeatAll()`, `defineVariable()`, `matchesFull()`, `indexOf()`, `lastIndexOf()`, `comparable()`, `pathname()`\n* Added aggregate functions: `sum()`, `min()`, `max()`, `avg()`\n* Added date/time component extraction functions: `yearOf()`, `monthOf()`, `dayOf()`, `hourOf()`, `minuteOf()`, `secondOf()`, `millisecondOf()`, `timezoneOffsetOf()`, `dateOf()`, `timeOf()`\n* Added boundary and precision functions: `lowBoundary()`, `highBoundary()`, `precision()`\n* Added support for Long (integer64) type with required `L` suffix\n* Added constructor syntax support for type instantiation\n* Added date/time subtraction operations\n* Added `combine()` function with `preserveOrder` parameter\n* Added case-sensitivity options to regex functions\n* Clarified singleton evaluation rules and function behavior for multi-item collections\n* Clarified iteration context and scoped function behavior\n* Clarified `iif()` delayed argument evaluation semantics\n* Clarified date/time arithmetic edge cases (overflow, fractions, subtraction)\n* Clarified quantity unit handling and UCUM conformance\n* Clarified equality semantics for collections\n* Clarified rounding behavior for negative numbers\n* Improved conversion documentation and `toString()` representations\n* Defined calendar duration units code system\n* Corrected numerous examples throughout\n* Updated implementation references\n* Added authors and contributors list\n* Typographical corrections throughout\n* Documentation source format changed from asciidoc to markdown\n* Simplified reflection capabilities - removed element information returned from `type()`\n* Added many new examples for functions that did not previously have examples\n\nsee [Change Notes](changes.html) for more details and related issue numbers."
  },
  {
    "version" : "3.0.0-ballot",
    "path" : "http://hl7.org/fhirpath/2025Jan",
    "status" : "ballot",
    "sequence" : "R3",
    "fhirversion" : "4.0.1",
    "date" : "2024-12-18",
    "desc" : "R2 STU1 Ballot (v3.0.0-ballot)",
    "descmd" : "Release 2 STU1 Ballot applying implementer feedback, additional functions and capabilities, as well as clarifications and corrections throughout."
  },
  {
    "version" : "2.0.0",
    "date" : "2020-Jan-16",
    "desc" : "Normative Release",
    "descmd" : "Normative Release. Changes:\r\n\r\n* Clarified calendar duration vs definite duration time-valued quantities\r\n* Clarified calendar semantics for date/time arithmetic\r\n* Clarified UCUM support conformance requirements\r\n* Added reference to conformance language\r\n* Reorganized conversion documentation for clarity\r\n* Clarified date/time literal in the grammar\r\n* Clarified conversion and formatting patterns throughout\r\n* Updated error handling language for consistency throughout\r\n* Added missing example explanations throughout\r\n* Added definitions and references for clarity throughout\r\n* Clarified escape-handling in strings and identifiers\r\n* Clarified unary operator precedence behavior\r\n* Clarified function invocation terms and descriptions throughout\r\n* Typographical corrections and clarifications throughout",
    "path" : "http://hl7.org/fhirpath/N1",
    "status" : "normative",
    "sequence" : "R2"
  },
  {
    "version" : "1.3.0",
    "date" : "2019-05-01",
    "descmd" : "3rd Normative Ballot. Changes:\r\n\r\n* Removed timezone offset from Time values (still present on DateTime values)\r\n* Corrected convertsToTime to not require the `T` prefix\r\n* Marked Aggregate and Reflection sections as STU\r\n* Defined seconds as a decimal rather than having a separate millisecond precision for comparison\r\n* Added .is() and .as() functions for backwards compatibility\r\n* Allowed strings to be used for environment variables for backwards compability\r\n* Added literal notation for parital datetimes\r\n* Added quantity conversion functions\r\n* Added contains as a keyword to the grammar\r\n* Added Math functions (as STU): .round(), .sqrt(), .log(), .exp(), .ln(), .power(), .floor(), .ceiling(), .truncate(), and .abs()\r\n* Added an optional argument to trace() to allow logged content to be shaped\r\n* Clarified today() and now() semantics and added timeOfDay()\r\n* Various errata and clarifications throughout.",
    "path" : "http://hl7.org/fhirpath/2019May",
    "status" : "ballot",
    "sequence" : "R2"
  },
  {
    "version" : "1.2.0",
    "date" : "2018-08-21",
    "descmd" : "2nd Normative Ballot. Changes:\r\n\r\n* Changed delimited identifiers to use a backtick rather than a double-quote\r\n* Changed isXXX conversion testing operators to convertsToXXX\r\n* Added Date type literals, system type, and operators\r\n* Clarified semantics of equality/equivalence for Date/Time types\r\n* Added weeks to Date/Time addition/subtraction\r\n* Clarified partial Date/Time comparison semantics\r\n* Various errata and clarifications throughout",
    "path" : "http://hl7.org/fhirpath/2018Sep",
    "status" : "ballot",
    "sequence" : "R2"
  },
  {
    "version" : "1.1.0",
    "date" : "2018-03-31",
    "descmd" : "Normative Ballot. Changes:\r\n\r\n* Added terminology operators to FHIR appendix\r\n* Increased precedence of is/as operators\r\n* Added .aggregate() operator\r\n* Clarified support for namespaces in FHIRPath and its usage contexts (FHIR, CQL, V2)\r\n* Relaxed conversion failures to return null instead of throw an error\r\n* Added support for quantity comparisons\r\n* Relaxed definition of code equivalence (only uses code and system, not version or text/display)\r\n* Added $index accessor to iteratio contexts\r\n* Added profile validation operators to FHIR appendix\r\n\r\nSee changes from ballot to release for the [spec](http://services.w3.org/htmldiff?doc1=http%3A%2F%2Fhl7.org%2Ffhirpath%2F2016Sept%2Findex.html&doc2=http%3A%2F%2Fhl7.org%2Ffhirpath%2Findex.html) or the [grammar](http://services.w3.org/htmldiff?doc1=http%3A%2F%2Fhl7.org%2Ffhirpath%2F2016Sept%2Fgrammar.html&doc2=http%3A%2F%2Fhl7.org%2Ffhirpath%2Fgrammar.html)",
    "path" : "http://hl7.org/fhirpath/2018May",
    "status" : "ballot",
    "sequence" : "R1"
  },
  {
    "version" : "1.0.0",
    "date" : "2016-12-06",
    "descmd" : "STU1 Release. Changes:\r\n* Rename from FluentPath to FHIRPath for trademark reasons\r\n* Added string concatenate (&) operator\r\n* Added URI and Media Types\r\n* Added combine operator to support combining lists without removing duplicates\r\n* Added anyFalse and allFalse operators\r\n* Clarified lexical elements for whitespace, comments, case-sensitivity, etc.\r\n* Added ability to reference case-insensitive models, and note about models specifying alternative collection offsets\r\n* Added a usage appendix for HL7 V2\r\n* Added an implementation appendix\r\n* Added examples and clarifying documentation throughout\r\n\r\nSee changes from ballot to release for the [spec](http://services.w3.org/htmldiff?doc1=http%3A%2F%2Fhl7.org%2Ffhirpath%2F2016Sept%2Findex.html&doc2=http%3A%2F%2Fhl7.org%2Ffhirpath%2Findex.html) or the [grammar](http://services.w3.org/htmldiff?doc1=http%3A%2F%2Fhl7.org%2Ffhirpath%2F2016Sept%2Fgrammar.html&doc2=http%3A%2F%2Fhl7.org%2Ffhirpath%2Fgrammar.html)",
    "path" : "http://hl7.org/fhirpath/2017Jan",
    "status" : "trial-use",
    "sequence" : "R1"
  },
  {
    "version" : "0.3.0",
    "date" : "2016-08-11",
    "descmd" : "STU1 Ballot. Changes:\r\n* refine notions around 3 value Boolean logic\r\n* clarify use & syntax of constants\r\n* add date operations\r\n* many minor changes to functions\r\n* provide test cases for FHIR implementations\r\n* added support for reflection\r\n* improved support for extensions and profiles in FHIR",
    "path" : "http://hl7.org/fhirpath/2016Sept",
    "status" : "ballot",
    "sequence" : "R1"
  },
  {
    "version" : "0.2.0",
    "date" : "2015-03-31",
    "descmd" : "STU1 Draft (first joint version between FHIR & CQL)",
    "path" : "http://hl7.org/fhirpath/2016May",
    "status" : "ballot",
    "sequence" : "R1"
  }]
}
