Data Model Documentation

 

date

The date element, containing a calendar date.

Description

The date element contains the text of the date. This keeps the structure simple, allowing variety of type and style of date, leaving the attributes to capture functional information:

calendar indicates which calendar system the date follows. Examples include Islamic, Julian, Gregorian. QA rules will enforce the values. If the value is Gregorian QA rules will ensure that ISO dates are also present.

era indicates an era within a particular calendar, e.g AD/BC/CE/BCE in the Gregorian/Julian calendars, H/HE in the Islamic calendar. The era attribute could also be used for regnal eras, for example Chinese dynasties.

qualifier contains a word or character used where the date is uncertain, e.g.

  • c [circa]
  • a [ante]
  • ? [uncertain]

isoDate contains a date in ISO 8601 format, representing the date as accurately as the text allows, i.e. YYYY, YYYY-MM, or YYYY-MM-DD.

isoStart and isoEnd contains ISO 8601 dates noting the start and end of a period. Use either these or isoDate, but not both.

day, month and year should be used only for non-Gregorian calendars where it is not possible to express day, month, year in the ISO 8601 format YYYY-MM-DD.

role is a generic attribute, that could be used to indicate whether the date is a birth date, death date, etc.

DTD declaration

<!ELEMENT date (%content;)*>

Children

Attributes

Name

Type

Value

calendar

CDATA

#IMPLIED

day

CDATA

#IMPLIED

era

CDATA

#IMPLIED

id

ID

#IMPLIED

isoDate

CDATA

#IMPLIED

isoEnd

CDATA

#IMPLIED

isoStart

CDATA

#IMPLIED

month

CDATA

#IMPLIED

qualifier

CDATA

#IMPLIED

role

CDATA

#IMPLIED

year

CDATA

#IMPLIED

Parents

Special features

  • Mixed content element