Duration
How long something lasts: as text, as a quantity or range, with a flag for whether it will vary between participants and why.
- Kind
- Concrete class
- Group
- Schedule and timing
- Attributes
- 7, 3 required
- NCI code
- C25330
Official definition
The length of time during which something continues.
In practice
In a protocol document: Planned duration of treatment or of participation.
Attributes
7 attributes, 3 of them required by the USDM API schema.
| Attribute | Type | Card. | Definition |
|---|---|---|---|
| idrequired | string | cardinality 1 | The identifier of this object, unique within the file. |
| text | string | cardinality 0..1 | An instance of unstructured text that represents the event duration. |
| quantity | QuantityRange | cardinality 0..1 | The value representing the amount of time over which the event occurs. |
| durationWillVaryrequired | boolean | cardinality 1 | An indication as to whether the event duration is planned to vary within and/or across subjects. |
| reasonDurationWillVary | string | cardinality 0..1 | The explanation for why the event duration will vary within and/or across subjects. |
| extensionAttributes | ExtensionAttribute | cardinality 0..* | Extension attributes attached to this object, for information the standard does not define. Added by the API; not part of the logical model. |
| instanceTyperequired | string | cardinality 1 | The name of the class, carried by every object in a USDM JSON file. Added by the API; not part of the logical model. |
Smallest valid Duration
The attributes a JSON file must carry for a Duration, and the kind of value each takes. This is the shape, with types named in place of values. Everything else in the table above is optional.
Duration, required attributes only
{
"id": "Duration_1",
"durationWillVary": boolean,
"instanceType": "Duration"
}
Where Duration is used
These classes hold or point to a Duration.
- Administration.durationnested
- ScheduleTimeline.plannedDurationnested
Example
A Duration from the example study. Coded values are shortened to one line.
Duration_3
{
"id": "Duration_3",
"text": "16 weeks",
"quantity": {
"id": "Quantity_7",
"value": 16,
"unit": { "standardCode": { "code": "C29844", "decode": "Week", … }, … },
"instanceType": "Quantity"
},
"durationWillVary": false,
"instanceType": "Duration"
}
Related classes
Other classes in schedule and timing: