Uploaded image for project: 'FHIR Specification Feedback'
  1. FHIR Specification Feedback
  2. FHIR-26564

Provide guidance about use of calendar duration vs UCUM units for time-valued quantities in CQL

    XMLWordPrintableJSON

    Details

    • Type: Change Request
    • Status: Published (View Workflow)
    • Priority: Medium
    • Resolution: Persuasive
    • Specification:
      US Quality Measures (FHIR)
    • Raised in Version:
      0.1
    • Work Group:
      Clinical Quality Information
    • Related Page(s):
      CQL Basics
    • Grouping:
    • Resolution Description:
      Hide

      For time-valued quantities, in addition to the definite duration UCUM units, CQL defines calendar duration keywords to support calendar-based durations and arithmetic. For example, UCUM defines an annum (`'a'`) as 365.25 days, whereas the year (`'year'`) duration in CQL is specifically a calendar year. This difference is important, especially when performing calendar arithmetic.

      // Example of using a calendar-based calculation versusu a definite-time duration calculation

      See the definition of the [Quantity](https://cql.hl7.org/2020May/02-authorsguide.html#quantities) type in the CQL Author's Guide, as well as the [Date/Time Arithmetic](https://cql.hl7.org/2020May/02-authorsguide.html#datetime-arithmetic) discussion for more information.

       

      Show
      For time-valued quantities, in addition to the definite duration UCUM units, CQL defines calendar duration keywords to support calendar-based durations and arithmetic. For example, UCUM defines an annum (`'a'`) as 365.25 days, whereas the year (`'year'`) duration in CQL is specifically a calendar year. This difference is important, especially when performing calendar arithmetic. // Example of using a calendar-based calculation versusu a definite-time duration calculation See the definition of the [Quantity] ( https://cql.hl7.org/2020May/02-authorsguide.html#quantities ) type in the CQL Author's Guide, as well as the [Date/Time Arithmetic] ( https://cql.hl7.org/2020May/02-authorsguide.html#datetime-arithmetic ) discussion for more information.  
    • Resolution Vote:
      Floyd Eisenberg/Rob Samples: 27-0-1
    • Change Category:
      Clarification
    • Change Impact:
      Non-substantive

      Description

      Provide guidance for and a description of the difference between UCUM units and calendar durations for time-valued durations, and clearly indicate that the use of UCUM units for time-valued durations has different behavior.

        Attachments

          Activity

            People

            Assignee:
            bryn.rhodes Bryn Rhodes
            Reporter:
            bryn.rhodes Bryn Rhodes
            Watchers:
            3 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved:
              Vote Date: