FHIR Extensions Pack
5.3.0-ballot-tc1 - (September 2025 Ballot) International flag

This page is part of the FHIR Core Extensions Registry (v5.3.0-ballot-tc1: Release 5.3) based on FHIR (HL7® FHIR® Standard) v5.0.0. This version is a pre-release. The current official version is 5.2.0. For a full list of available versions, see the Directory of published versions

Extension: Relative date time

Official URL: http://hl7.org/fhir/StructureDefinition/cqf-relativeDateTime Version: 5.3.0-ballot-tc1
Standards status: Deprecated Maturity Level: 3 Responsible: HL7 International / Clinical Decision Support Computable Name: RelativeDateTime
Other Identifiers: OID:2.16.840.1.113883.4.642.5.1685

A date/time value that is determined based on a duration offset from a target event. DEPRECATED: This extension has been deprecated in favor of the new relative-time extension.

Context of Use

This extension is deprecated and should no longer be used

This extension has been deprecated in favor of the new relative-time extension.

This extension may be used on the following element(s)

Usage info

Usages:

  • This Extension is not used by any profiles in this Implementation Guide

You can also check for usages in the FHIR IG Statistics

Changes since version 5.2.0:

  • No changes

    • Formal Views of Extension Content

    Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

    This structure is derived from Extension

    Summary

    Complex Extension: A date/time value that is determined based on a duration offset from a target event. DEPRECATED: This extension has been deprecated in favor of the new relative-time extension.

    • target: Reference: The event that the date/time value is relative to.
    • targetPath: string: The path to the element that defines the effective period for the event that the date/time value is relative to.
    • relationship: code: The relationship to the effective period of the target event that the date/time value is relative to.
    • offset: Duration, Range: A duration or range of durations that specifies the offset between the date/time value and the target event. For example, 30-60 minutes before.

    Maturity: 3

    This structure is derived from Extension

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..1 Extension DEPRECATED A date/time that is specified relative to another event
    ... Slices for extension Content/Rules for all slices
    .... extension:target 1..1 Extension Relative to what event
    ..... extension 0..0
    ..... url 1..1 uri "target"
    ..... value[x] 1..1 Reference(Resource) Value of extension
    .... extension:targetPath 1..1 Extension Relative to which element on the event
    ..... extension 0..0
    ..... url 1..1 uri "targetPath"
    ..... value[x] 1..1 string Value of extension
    .... extension:relationship 1..1 Extension before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end
    ..... extension 0..0
    ..... url 1..1 uri "relationship"
    ..... value[x] 1..1 code Value of extension
    Binding: ActionRelationshipType (required)
    .... extension:offset 1..1 Extension How long
    ..... extension 0..0
    ..... url 1..1 uri "offset"
    ..... value[x] 1..1 Value of extension
    ...... valueDuration Duration
    ...... valueRange Range
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/cqf-relativeDateTime"
    ... value[x] 0..0

    doco Documentation for this format
    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..1 Extension DEPRECATED A date/time that is specified relative to another event
    ... id 0..1 id Unique id for inter-element referencing
    ... Slices for extension 4..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    .... extension:target 1..1 Extension Relative to what event
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "target"
    ..... value[x] 1..1 Reference(Resource) Value of extension
    .... extension:targetPath 1..1 Extension Relative to which element on the event
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "targetPath"
    ..... value[x] 1..1 string Value of extension
    .... extension:relationship 1..1 Extension before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "relationship"
    ..... value[x] 1..1 code Value of extension
    Binding: ActionRelationshipType (required)
    .... extension:offset 1..1 Extension How long
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "offset"
    ..... value[x] 1..1 Value of extension
    ...... valueDuration Duration
    ...... valueRange Range
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/cqf-relativeDateTime"

    doco Documentation for this format

    This structure is derived from Extension

    Summary

    Complex Extension: A date/time value that is determined based on a duration offset from a target event. DEPRECATED: This extension has been deprecated in favor of the new relative-time extension.

    • target: Reference: The event that the date/time value is relative to.
    • targetPath: string: The path to the element that defines the effective period for the event that the date/time value is relative to.
    • relationship: code: The relationship to the effective period of the target event that the date/time value is relative to.
    • offset: Duration, Range: A duration or range of durations that specifies the offset between the date/time value and the target event. For example, 30-60 minutes before.

    Maturity: 3

    Differential View

    This structure is derived from Extension

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..1 Extension DEPRECATED A date/time that is specified relative to another event
    ... Slices for extension Content/Rules for all slices
    .... extension:target 1..1 Extension Relative to what event
    ..... extension 0..0
    ..... url 1..1 uri "target"
    ..... value[x] 1..1 Reference(Resource) Value of extension
    .... extension:targetPath 1..1 Extension Relative to which element on the event
    ..... extension 0..0
    ..... url 1..1 uri "targetPath"
    ..... value[x] 1..1 string Value of extension
    .... extension:relationship 1..1 Extension before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end
    ..... extension 0..0
    ..... url 1..1 uri "relationship"
    ..... value[x] 1..1 code Value of extension
    Binding: ActionRelationshipType (required)
    .... extension:offset 1..1 Extension How long
    ..... extension 0..0
    ..... url 1..1 uri "offset"
    ..... value[x] 1..1 Value of extension
    ...... valueDuration Duration
    ...... valueRange Range
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/cqf-relativeDateTime"
    ... value[x] 0..0

    doco Documentation for this format

    Snapshot View

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..1 Extension DEPRECATED A date/time that is specified relative to another event
    ... id 0..1 id Unique id for inter-element referencing
    ... Slices for extension 4..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    .... extension:target 1..1 Extension Relative to what event
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "target"
    ..... value[x] 1..1 Reference(Resource) Value of extension
    .... extension:targetPath 1..1 Extension Relative to which element on the event
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "targetPath"
    ..... value[x] 1..1 string Value of extension
    .... extension:relationship 1..1 Extension before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "relationship"
    ..... value[x] 1..1 code Value of extension
    Binding: ActionRelationshipType (required)
    .... extension:offset 1..1 Extension How long
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "offset"
    ..... value[x] 1..1 Value of extension
    ...... valueDuration Duration
    ...... valueRange Range
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/cqf-relativeDateTime"

    doco Documentation for this format

     

    Other representations of profile: CSV, Excel, Schematron

    Terminology Bindings

    PathConformanceValueSetURI
    Extension.extension:relationship.value[x]requiredActionRelationshipType
    http://hl7.org/fhir/ValueSet/action-relationship-type
    From the FHIR Standard

    Constraints

    IdGradePath(s)DetailsRequirements
    ele-1error**ALL** elementsAll FHIR elements must have a @value or children
    : hasValue() or (children().count() > id.count())
    ext-1error**ALL** extensionsMust have either extensions or value[x], not both
    : extension.exists() != value.exists()

    R4B

    The extension is unchanged in R4B

    R4

    The extension is unchanged in R4

    R3

    The extension is unchanged in R3

    Search Parameters for this Extension

    (none found)