Age

The Age element allows the age of the subject to be encoded in several different ways that support different use cases. Age is encoded as ISO8601 duration.

Data model

Field	Type	Status	Description
age	string	required	An ISO8601 string represent age

If the Age message is used, the age value must be present.

Example

{
    "age": "P25Y3M2D"
}

The string element (string age=1) should be used for ISO8601 durations (e.g., P40Y10M05D). For many use cases, less precise strings will be preferred for privacy reasons, e.g., P40Y.

age

It is possible to represent age using a string that should be formated according as ISO8601 Duration.

AgeRange

The AgeRange element is inteded to be used when the age of a subject is represented by a bin, e.g., 5-10 years. Bins such as this are used in some situations in order to protect the privacy of study participants, whose age is then represented by bins such as 45-49 years, 50-54 years, 55-59 years, and so on.

Data model

Field	Type	Status	Description
start	Age	required	An Age message
end	Age	required	An Age message

Example

For instance, to represent the bin 45-49 years, one could use an Age element with P45Y as the start element of the AgeRange element, and an Age element with P49Y as the end element. An AgeRange.end SHALL occur after AgeRange.start.

{
  "start": {
      "age": "P45Y"
  },
  "end": {
      "age": "P49Y"
  }
}