12.3.11. att.datable.w3c

att.datable.w3c provides attributes for normalization of elements that contain datable events conforming to the W3C XML Schema Part 2: Datatypes Second Edition. [3.6.4. Dates and Times 14.4. Dates]

Module tei — Specification

Members att.datable[att.gaijiProp[localProp unicodeProp unihanProp] affiliation age author change date editor education faith floruit gender idno langKnowledge langKnown licence mapping name nationality occupation orgName persName persPronouns placeName principal residence resp sex socecStatus state title trait] orth pron

Attributes

when

supplies the value of the date or time in a standard form, e.g. yyyy-mm-dd.

Status	Optional
Datatype	teidata.temporal.w3c
Examples of W3C date, time, and date & time formats. <p> <date when="1945-10-24">24 Oct 45</date> <date when="1996-09-24T07:25:00Z">September 24th, 1996 at 3:25 in the morning</date> <time when="1999-01-04T20:42:00-05:00">Jan 4 1999 at 8 pm</time> <time when="14:12:38">fourteen twelve and 38 seconds</time> <date when="1962-10">October of 1962</date> <date when="--06-12">June 12th</date> <date when="---01">the first of the month</date> <date when="--08">August</date> <date when="2006">MMVI</date> <date when="0056">AD 56</date> <date when="-0056">56 BC</date> </p>
`This list begins in the year 1632, more precisely on Trinity Sunday, i.e. the Sunday after Pentecost, in that year the <date calendar="#julian" when="1632-06-06">27th of May (old style)</date>.`
`<opener> <dateline> <placeName>Dorchester, Village,</placeName> <date when="1828-03-02">March 2d. 1828.</date> </dateline> <salute>To Mrs. Cornell,</salute> Sunday <time when="12:00:00">noon.</time> </opener>`

notBefore

specifies the earliest possible date for the event in standard form, e.g. yyyy-mm-dd.

Status	Optional
Datatype	teidata.temporal.w3c

notAfter

specifies the latest possible date for the event in standard form, e.g. yyyy-mm-dd.

Status	Optional
Datatype	teidata.temporal.w3c

from

indicates the starting point of the period in standard form, e.g. yyyy-mm-dd.

Status	Optional
Datatype	teidata.temporal.w3c

indicates the ending point of the period in standard form, e.g. yyyy-mm-dd.

Status	Optional
Datatype	teidata.temporal.w3c

Schematron

<sch:rule context="tei:*[@when]"> <sch:report test="@notBefore|@notAfter|@from|@to" role="nonfatal">The @when attribute cannot be used with any other att.datable.w3c attributes.</sch:report> </sch:rule>

Schematron

<sch:rule context="tei:*[@from]"> <sch:report test="@notBefore" role="nonfatal">The @from and @notBefore attributes cannot be used together.</sch:report> </sch:rule>

Schematron

<sch:rule context="tei:*[@to]"> <sch:report test="@notAfter" role="nonfatal">The @to and @notAfter attributes cannot be used together.</sch:report> </sch:rule>

Example

<date from="1863-05-28" to="1863-06-01">28 May through 1 June 1863</date>

Note

The value of these attributes should be a normalized representation of the date, time, or combined date & time intended, in any of the standard formats specified by XML Schema Part 2: Datatypes Second Edition, using the Gregorian calendar.

The most commonly-encountered format for the date portion of a temporal attribute is yyyy-mm-dd, but yyyy, --mm, ---dd, yyyy-mm, or --mm-dd may also be used. For the time part, the form hh:mm:ss is used.

Note that this format does not currently permit use of the value 0000 to represent the year 1 BCE; instead the value -0001 should be used.