This page is part of the Vital Records Common Profile Library (v2.0.0-ballot: STU 2 Ballot 1) based on FHIR (HL7® FHIR® Standard) R4. The current version which supersedes this version is 1.1.0. For a full list of available versions, see the Directory of published versions

Usage

Partial Dates and Times

The purpose of the these extensions (ExtensionPartialDateVitalRecords and ExtensionPartialDateTimeVitalRecords) is to be able to express date and datetime values when some components are not known. For some fields reported in vital records, all four components (year, month, day, time) can be reported/absent independently, resulting in combinations that are not supported by a FHIR dateTime (YYYY, YYYY-MM, YYYY-MM-DD, or a full dateTime). The additional combinations supported by these extensions include:

• YYYY-XX-DD (year & day with no month)
• XXXX-MM-DD (month & day with no year)
• XXXX-XX-DD (day only)
• XXXX-XX-XX (no recorded date)
• All of the above options with present or missing time

When using these extensions, a value must be specified for each component (e.g., year, month, day), or a missing value code specified. This allows dates where any component is missing to be specified. These extensions SHALL NOT be used to represent partial values that can be represented by the FHIR date and dateTime directly. The value of the field being extended should provide the portion of the date or dateTime value that can be represented by the FHIR data type. For example, if the date is 2023-XX-01 (the month being unknown), the value of the date should be 2023, and the partialDate extension would represent all three components.

A value of unknown (all 9’s) in IJE is equivalent to a null value and a DataAbsentReason extension. See this for an example of both unknown integer values – an unknown month of birth, “99” in IJE – and unknown time value – the time of birth, “9999” in IJE.

Birth Date and Time

The USCorePatient profile provides a field for capturing the patient’s birthdate. Within the vital records use cases, the date and time of birth are needed, as well as the ability to capture partial dates. The date and time of birth should be captured as follows:

• If both the date and time of birth are known, the Patient.birthDate field should include the birth date, and the PatientBirthTime extension should include the birth date and time encoded as a FHIR dateTIme. Example: patient-child-vr-babyg-quinn-common.
• If the date of birth is known, but the time of birth is unknown, the Patient.birthDate field should include the birth date, and the PatientBirthTime and ExtensionPartialDateTimeVitalRecords extensions should be omitted. Example: patient-child-vr-babyg-quinn-common-1
• If the date of birth is partially known, the ExtensionPartialDateTimeVitalRecords extension should be used to express this. If the partial date can be expressed within the birthDate field it should be included there as well. The PatientBirthTime extension should be omitted. Example: patient-child-vr-babyg-quinn-common-2

City Codes

FHIR addresses support a string value for city. The death record submission requires a 5 digit coded value, so the IG defines an extension ExtensionCityCodeVitalRecords for this purpose. The code should be selected to match the literal content of the city field. As of the date of publication, these codes should be in accordance with the NCHS Instruction Manual Part 8, Vital Records Geographic Classification, 2014.

County Codes

FHIR addresses support a string value for county (district). The death record submission requires a 3 digit coded value, so the IG defines an extension ExtensionDistrictCodeVitalRecords for this purpose. The code should be selected to match the literal content of the district field. As of the date of publication, these codes should be in accordance with the NCHS Instruction Manual Part 8, Vital Records Geographic Classification, 2014.

State Literals

States and jurisdictions are consistently represented using two letter postal codes bound to a string field. The IJE typically represents states using a 2 letter postal code and a separate literal field. Mapping from the 2 letter codes to literals must be provided outside of the VRCL IG, and can leverage the ValueSetStatesTerritoriesAndProvincesVitalRecords.

Country Literals

Countries are consistently represented using two letter postal codes bound to a string field. The IJE typically represents countries using a 2 letter postal code and a separate literal field. Mapping from the 2 letter codes to literals must be provided outside of the VRCL IG, and can leverage the CodeSystemCountryCodeVitalRecords.

Gender

Profile conformance requires that gender be provided. A value of ‘unknown’ will satisfy this requirement. There is no IJE field that is mapped to the Patient.gender field.

Handling of Edit Flags

TBD