Clinical Quality Language Specification
1.5.3 - Release 1 Errata 2

Clinical Quality Language Specification, published by Clinical Decision Support WG. This guide is not an authorized publication; it is the continuous build for version 1.5.3 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cql/ and changes regularly. See the Directory of published versions

V1.5 Change Log

Page standards status: Informative Maturity Level: N/A

1.5 Change Log

Ballot Changes (v.1.5.0)

Normative Changes

Compatible, Substantive
  • STU4#1877: Added support for modular arithmetic for quantities
  • STU4#1896: Added an overload of expand to take a single interval
  • STU4#1917: Added a text/cql.identifier media type to support referencing the name of a defined CQL expression
Non-Substantive
  • STU4#1909: Added guidance on local terminology identifiers
  • STU4#1911: Clarified that unit conversion is supported with ConvertQuantity
  • STU4#1912: Clarified representation of seconds and milliseconds as a Decimal for the purposes of comparison
  • STU4#1916: Added guidance on direct-reference code usage
Errata
  • STU3#1875: Corrected error in Exists documentation
  • STU4#1857: Corrected error in ToString documentation
  • STU4#1858: Clarified relationship between CQL calendar duration units and UCUM definite-duration units
  • STU4#1862: Corrected rendering of formatting strings footnote throughout
  • STU4#1863: Clarified role of date and time token definitions in the grammar
  • STU4#1864: Updated typographical conventions for formatting strings throughout
  • STU4#1865: Clarified ranges for date/time formatting strings
  • STU4#1866: Clarified date/time arithmetic conversion semantics between UCUM and calendar duration units
  • STU4#1867: Clarified date/time arithmetic semantics for precisions above seconds
  • STU4#1869: Clarified date/time literal rules for timezoneoffset
  • STU4#1876: Fixed test for exists
  • STU4#1878: Clarified collapse and expand semantics with respect to per argument and interval boundary alignment
  • STU4#1881: Added point keyword to appropriate keyword lists
  • STU4#1882: Clarified semantics and behavior of terminology comparisons in retrieves
  • STU4#1883: Clarified inconsistent null semantics for point and singleton overloads of includes and included in as synonyms for in and contains
  • STU4#1884: Documented ToConcept(List) overload
  • STU4#1897: Clarified semantics and behavior of interval in and contains in the presence of interval boundaries that are both open and null
  • STU4#1913: Removed note about timezoneoffset in Time ELM operator
  • STU4#1914: Fixed rendering of footnote to formatting strings throughout
  • STU4#1915: Added guidance on local identifiers for code system, value set, and code declarations (duplicate of STU4#1909)
  • STU4#1919: Added missing Description header in documentation of ConvertQuantity and HighBoundary operators

Trial-Use Ballot Changes

Compatible, Substantive
  • STU4#1907: Added an aggregate clause to the query construct
  • STU4#1908: Added the ability to pass value sets and code systems as reference-type arguments
  • STU4#1910: Added support for specifying search paths in the Retrieve
  • STU4#1918: Added support for comment annotations that result in tags in the ELM output
  • STU4#1920: Added a fluent keyword to support fluent-style function invocation
  • STU4#1921: Added support for specifying include and reverseInclude elements in the Retrieve
  • STU4#1923: Added System.Long to support 64-bit integers

Release Changes (v1.5.1)

Normative Changes

Non-substantive

Trial-Use Changes

Non-substantive

Informative Changes

Non-substantive

Errata

Errata 1 Changes (v1.5.2)

Trial-Use Changes

Compatible, Substantive
  • FHIR-32666: Add version parameter for media types
  • FHIR-34804: Improve backwards compatibility support for terminology types

Normative Changes

Non-substantive
  • FHIR-35869: Inconsistent description of ToDateTime operator
  • FHIR-32951: Function-style invocation of keyword operators is not documented
  • FHIR-32950: Interval overload of between is not documented
  • FHIR-35926: Clarify Quantity Predecessor/Successor behavior
  • FHIR-35925: Correct missing quantity overloads in Logical Specification
  • FHIR-35917: Fix missing IdentifierRef documentation
  • FHIR-35915: Clarify interval computation semantics with open null boundaries
  • FHIR-35909: Add a clarifying example to the uncertainty calculation discussion
  • FHIR-35905: Clarify the result of a DateTime with all null components
  • FHIR-35904: Clarify equality semantics exception for nulls
  • FHIR-32971: Use codeSystemEx and valueSetEx elements in value set membership operations

Informative Changes

  • FHIR-28127: Incorrect test case for single-source query sort
  • FHIR-31883: Diagram of interval operators uses "begins"
  • FHIR-35881: Document that test cases are built to be run with an evaluation timestamp of UTC
  • FHIR-35918: Add a best-practice about the use of equivalent rather than equal for terminology comparison
  • FHIR-34199: Document cql-options that affect language behavior
  • FHIR-32679: Compile specific behavior differences between 1.3/1.4/1.5
  • FHIR-30081: Errors in test cases

Errata 2 Changes (v1.5.3)

Non-substantive

  • FHIR-48757: Corrected precedence of FHIRPath | and infix set operators
  • FHIR-48530: Clarified timezone offset defaulting semantics in the DateTime type
  • FHIR-48482: Clarified seconds and milliseconds are a single precision in duration and difference calculations
  • FHIR-46707: Publication uplift to latest tooling (no material changes)
  • FHIR-46675: Clarified during operator synonyms in the reference
  • FHIR-46483: Corrected spelling of descendants operator as specified in FHIRPath
  • FHIR-46437: Added documentation about accessibility of $this and $index elements in sort expressions
  • FHIR-46436: Clarified identifier hiding semantics
  • FHIR-46435: Clarified implicit system model resolution semantics
  • FHIR-46434: Corrected inconsistent descriptions of combine semantics
  • FHIR-46426: Added missing mapping for union in FHIRPath
  • FHIR-46363: Clarified semantics of null for list membership determination in IndexOf and Equal
  • FHIR-46362: Clarified behavior of equivalent with respect to empty lists and strings
  • FHIR-46360: Clarified concept equivalence semantics
  • FHIR-46345: Clarified implicit system model resolution semantics
  • FHIR-46283: Clarified null behavior for properly includes and included in
  • FHIR-46051: Corrected description of meets and overlaps operators
  • FHIR-46053: Clarified semantics of is operator and linked to type testing discussion
  • FHIR-45987: Clarified round semantics
  • FHIR-45913: Fixed formatting of implicit conversions table
  • FHIR-45911: Added missing equivalent and not-equivalent symbols to the symbols table
  • FHIR-44921: Clarified tuple equality semantics with missing elements
  • FHIR-44830: Corrected day formatting range (01..31)
  • FHIR-44783: Clarified type compatibility in conversion precedence
  • FHIR-44780: Added missing Long overloads for ToQuantity conversions
  • FHIR-44826: Clarified regular expression matching behavior
  • FHIR-41489: Corrected inconsistent statements about overflow/underflow with successor and predecessor
  • FHIR-40225: Clarified query type inference and null evaluation semantics
  • FHIR-36050: Corrected links to raw g4 grammar files