HL7 Terminology (THO), published by HL7 International - Vocabulary Work Group. This guide is not an authorized publication; it is the continuous build for version 7.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/UTG/ and changes regularly. See the Directory of published versions
| Active as of 2025-06-27 |
@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
# - resource -------------------------------------------------------------------
a fhir:CodeSystem ;
fhir:nodeRole fhir:treeRoot ;
fhir:id [ fhir:v "time-period-ranges"] ; #
fhir:text [
fhir:status [ fhir:v "generated" ] ;
fhir:div [ fhir:v "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem time-period-ranges</b></p><a name=\"time-period-ranges\"> </a><a name=\"hctime-period-ranges\"> </a><p>This case-sensitive code system <code>http://terminology.hl7.org/CodeSystem/time-period-ranges</code> defines codes, but no codes are represented here</p></div>"^^rdf:XMLLiteral ]
] ; #
fhir:extension ( [
fhir:url [
fhir:v "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg"^^xsd:anyURI ;
fhir:l <http://hl7.org/fhir/StructureDefinition/structuredefinition-wg> ] ;
fhir:value [
a fhir:Code ;
fhir:v "cqi" ]
] ) ; #
fhir:url [
fhir:v "http://terminology.hl7.org/CodeSystem/time-period-ranges"^^xsd:anyURI ;
fhir:l <http://terminology.hl7.org/CodeSystem/time-period-ranges>
] ; #
fhir:version [ fhir:v "1.0.0"] ; #
fhir:name [ fhir:v "TimePeriodRanges"] ; #
fhir:title [ fhir:v "Time Period Ranges"] ; #
fhir:status [ fhir:v "active"] ; #
fhir:experimental [ fhir:v false] ; #
fhir:date [ fhir:v "2025-06-27"^^xsd:date] ; #
fhir:publisher [ fhir:v "HL7 International Clinical Quality Information Work Group"] ; #
fhir:contact ( [
( fhir:telecom [
fhir:system [ fhir:v "url" ] ;
fhir:value [ fhir:v "http://hl7.org/Special/committees/cqi" ] ] )
] [
( fhir:telecom [
fhir:system [ fhir:v "email" ] ;
fhir:value [ fhir:v "cqi@lists.hl7.org" ] ] )
] ) ; #
fhir:description [ fhir:v "Defines codes for the representation of time period (e.g. age) ranges that are unambiguous, human readable, and machine-readable as a compositional grammar (i.e. the code system defines rules for constructing codes, rather than explicitly enumerating all possible codes). This CodeSystem profiles [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) for expressing time period ranges through two simple durations (as defined in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) specification).\n\nCodes in the code system are defined according to the grammar:\n\nA time period (e.g. age) range is defined as two durations: `[duration1]--[duration2]`, where `duration1` specifies the lower inclusive bound of the age range (everyone who is this age and above) and `duration2` specifies the upper exclusive bound of the age range.\n\nFor example, the age range \"1-9 years\" means everyone who is at least one year old and less than 10 years old represented as `P1Y--P10Y`. The age range \"10-14 years\" means everyone who is at least 10 years old and less than 15 years old and is represented as `P10Y--P15Y`.\n\nDurations define the amount of time between two time points. These durations are represented in the form `P[n]Y[n]M[n]DT[n]H[n]M[n]S` or `P[n]W`. The `[n]` is replaced by the value for each of the time elements that follow the `[n]` and the letters have the meaning:\n\n* `P` is the duration designator (for period) placed at the start of the duration representation.\n * `Y` is the year designator that follows the value for the number of years.\n * `M` is the month designator that follows the value for the number of months.\n * `W` is the week designator that follows the value for the number of weeks.\n * `D` is the day designator that follows the value for the number of days.\n* `T` is the time designator that precedes the time components of the representation.\n * `H` is the hour designator that follows the value for the number of hours.\n * `M` is the minute designator that follows the value for the number of minutes.\n * `S` is the second designator that follows the value for the number of seconds. (Note that seconds can be a decimal in this format to allow for milliseconds)\n\nFor example, `P3Y6M4DT12H30M5S` represents a duration of _three years, six months, four days, twelve hours, thirty minutes, and five seconds_.\n\nDate and time elements including their designator may be omitted if their value is zero, and lower-order elements may also be omitted for reduced precision. For example, `P23DT23H` and `P4Y` are both acceptable duration representations. However, at least one element must be present, thus `P` is not a valid representation for a duration of _0 seconds_. `PT0S` or `P0D`, however, are both valid and represent the same duration.\n\nNote that the designator `M` is used for both months and minutes, but this is not ambiguous because the minutes designator must be preceded by the time designator `T`. For example `P1M` is _one month_, while `PT1M` is _one minute_.\n\nContent for this code system is adapted from the definition in the IHE-ADX profile: https://www.ihe.net/uploadedFiles/Documents/QRPH/IHE_QRPH_Suppl_ADX.pdf (Appendix 8K Representation of Age Groups in ADX). In addition, the code system definition is adapted from similar content published as part of the SANER implementation guide. See [Age Range Coding System](https://hl7.org/fhir/uv/saner/CodeSystem-IHE-ADX-agerange.html)."] ; #
fhir:jurisdiction ( [
( fhir:coding [
fhir:system [
fhir:v "http://unstats.un.org/unsd/methods/m49/m49.htm"^^xsd:anyURI ;
fhir:l <http://unstats.un.org/unsd/methods/m49/m49.htm> ] ;
fhir:code [ fhir:v "001" ] ] )
] ) ; #
fhir:purpose [ fhir:v "This code system is defined to support consistent, unambiguous, human- and machine-readable representations of time period ranges. A primary intended use case is to support the specification of value sets of age ranges for the purposes of data stratification (also referred to as disaggregation)."] ; #
fhir:copyright [
fhir:v "Adapted from content published by IHE Copyright (c) 2015 [IHE International, Inc](http://www.ihe.net/Governance/#Intellectual_Property). Used here according to the terms of the [CC BY 4 License](https://creativecommons.org/licenses/by/4.0/). This CodeSystem constitutes a profile on [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html), specifying use of its duration definitions for expressing time period ranges." ;
( fhir:extension [
fhir:url [
fhir:v "http://hl7.org/fhir/build/StructureDefinition/committee-notes"^^xsd:anyURI ;
fhir:l <http://hl7.org/fhir/build/StructureDefinition/committee-notes> ] ;
fhir:value [
a fhir:String ;
fhir:v "Rationale: The use of ISO 8601 by particular communities of practice via profiles is encouraged in the specification (older version text posted here [8601-2](https://www.loc.gov/standards/datetime/iso-tc154-wg5_n0039_iso_wd_8601-2_2016-02-16.pdf)) and an example given via [EDTF.](https://en.wikipedia.org/wiki/ISO_8601) There are other prominent, well-used profiles published by other SDOs, including: [RFC 3339 (IETF)](https://www.rfc-editor.org/rfc/rfc3339) and [W3C date and time](https://www.w3.org/TR/NOTE-datetime)." ] ] )
] ; #
fhir:caseSensitive [ fhir:v true] ; #
fhir:valueSet [
fhir:v "http://terminology.hl7.org/ValueSet/time-period-ranges"^^xsd:anyURI ;
fhir:l <http://terminology.hl7.org/ValueSet/time-period-ranges>
] ; #
fhir:compositional [ fhir:v true] ; #
fhir:content [ fhir:v "not-present"] . #
IG © 2020+ HL7 International - Vocabulary Work Group. Package hl7.terminology#7.0.0 based on FHIR 5.0.0. Generated 2025-11-26
Links: Table of Contents |
QA Report
| Version History
|
|
Propose a change