FHIR Timing Data Type (R4)
Timing describes when an event occurs or should occur: specific times, or a repeating schedule such as twice daily for 7 days. Element table, example JSON and FHIRPath for FHIR R4.
- FHIR Timing Data Type (R4) — part of the free FHIR Toolbox library.
- Runs entirely in your browser: your FHIR data is never uploaded to a server.
Overview
Timing describes when an event occurs or should occur: specific times, or a repeating schedule such as twice daily for 7 days. It is used for medication dosage and service scheduling.
Elements
| Element | Type | Cardinality | Description |
|---|---|---|---|
| Timing.event | dateTime | 0..* | When the event occurs |
| Timing.repeat | Element | 0..1 | When the event is to occur |
| Timing.repeat.id | String | 0..1 | Unique id for inter-element referencing |
| Timing.repeat.extension | Extension | 0..* | Additional content defined by implementations |
| Timing.repeat.bounds[x] | Duration | Range | Period | 0..1 | Length/Range of lengths, or (Start and/or end) limits |
| Timing.repeat.count | positiveInt | 0..1 | Number of times to repeat |
| Timing.repeat.countMax | positiveInt | 0..1 | Maximum number of times to repeat |
| Timing.repeat.duration | decimal | 0..1 | How long when it happens |
| Timing.repeat.durationMax | decimal | 0..1 | How long when it happens (Max) |
| Timing.repeat.durationUnit | code | 0..1 | s | min | h | d | wk | mo | a - unit of time (UCUM) |
| Timing.repeat.frequency | positiveInt | 0..1 | Event occurs frequency times per period |
| Timing.repeat.frequencyMax | positiveInt | 0..1 | Event occurs up to frequencyMax times per period |
| Timing.repeat.period | decimal | 0..1 | Event occurs frequency times per period |
| Timing.repeat.periodMax | decimal | 0..1 | Upper limit of period (3-4 hours) |
| Timing.repeat.periodUnit | code | 0..1 | s | min | h | d | wk | mo | a - unit of time (UCUM) |
| Timing.repeat.dayOfWeek | code | 0..* | mon | tue | wed | thu | fri | sat | sun |
| Timing.repeat.timeOfDay | time | 0..* | Time of day for action |
| Timing.repeat.when | code | 0..* | Code for time period of occurrence |
| Timing.repeat.offset | unsignedInt | 0..1 | Minutes from event (before or after) |
| Timing.code | CodeableConcept | 0..1 | BID | TID | QID | AM | PM | QD | QOD | + |
Example JSON (R4)
{
"repeat": {
"frequency": 2,
"period": 1,
"periodUnit": "d",
"boundsPeriod": {
"start": "2024-05-01",
"end": "2024-05-08"
}
},
"code": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-GTSAbbreviation",
"code": "BID"
}
]
}
}
FHIRPath
MedicationRequest.dosageInstruction.timing.repeat.frequency— How often the dose is repeated
FHIR Toolbox is a free, privacy-first collection of HL7 FHIR utilities by Omindra Labs. Every tool performs zero-server processing — your health data never leaves your device.