https://github.com/TEIC/TEI
Tip revision: 347c64fac3fa1a64ade0d8d1842813d4b8f7acec authored by Hugh Cayless on 12 May 2017, 16:57:59 UTC
Updates.
Updates.
Tip revision: 347c64f
ref-att.datable.w3c.html
<!DOCTYPE html
SYSTEM "about:legacy-compat">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><!--THIS FILE IS GENERATED FROM AN XML MASTER. DO NOT EDIT (7)--><title>TEI class att.datable.w3c </title><meta property="Language" content="en" /><meta property="DC.Title" content="TEI class att.datable.w3c " /><meta property="DC.Language" content="SCHEME=iso639 en" /><meta property="DC.Creator.Address" content="tei@oucs.ox.ac.uk" /><meta charset="utf-8" /><link href="guidelines.css" rel="stylesheet" type="text/css" /><link href="odd.css" rel="stylesheet" type="text/css" /><link rel="stylesheet" media="print" type="text/css" href="guidelines-print.css" /><script type="text/javascript" src="jquery-1.2.6.min.js"></script><script type="text/javascript" src="columnlist.js"></script><script type="text/javascript" src="popupFootnotes.js"></script><script type="text/javascript">
$(function() {
$('ul.attrefs-class').columnizeList({cols:3,width:30,unit:'%'});
$('ul.attrefs-element').columnizeList({cols:3,width:30,unit:'%'});
$(".displayRelaxButton").click(function() {
$(this).parent().find('.RNG_XML').toggle();
$(this).parent().find('.RNG_Compact').toggle();
});
$(".tocTree .showhide").click(function() {
$(this).find(".tocShow,.tocHide").toggle();
$(this).parent().find("ul.continuedtoc").toggle();
});
})
</script><script type="text/javascript"><!--
var displayXML=0;
states=new Array()
states[0]="element-a"
states[1]="element-b"
states[2]="element-c"
states[3]="element-d"
states[4]="element-e"
states[5]="element-f"
states[6]="element-g"
states[7]="element-h"
states[8]="element-i"
states[9]="element-j"
states[10]="element-k"
states[11]="element-l"
states[12]="element-m"
states[13]="element-n"
states[14]="element-o"
states[15]="element-p"
states[16]="element-q"
states[17]="element-r"
states[18]="element-s"
states[19]="element-t"
states[20]="element-u"
states[21]="element-v"
states[22]="element-w"
states[23]="element-x"
states[24]="element-y"
states[25]="element-z"
function startUp() {
}
function hideallExcept(elm) {
for (var i = 0; i < states.length; i++) {
var layer;
if (layer = document.getElementById(states[i]) ) {
if (states[i] != elm) {
layer.style.display = "none";
}
else {
layer.style.display = "block";
}
}
}
var mod;
if ( mod = document.getElementById('byMod') ) {
mod.style.display = "none";
}
}
function showall() {
for (var i = 0; i < states.length; i++) {
var layer;
if (layer = document.getElementById(states[i]) ) {
layer.style.display = "block";
}
}
}
function showByMod() {
hideallExcept('');
var mod;
if (mod = document.getElementById('byMod') ) {
mod.style.display = "block";
}
}
--></script></head><body id="TOP"><div id="container"><div id="banner"><img src="Images/banner.jpg" alt="Text Encoding Initiative logo and banner" /></div></div><div class="mainhead"><h1>P5:
Guidelines for Electronic Text Encoding and Interchange</h1><p>Version 3.1.1a. Last updated on
10th May 2017, revision bd8dda3</p></div><div class="main-content"><div class="miniTOC miniTOC_right"><ul class="subtoc"><li class="subtoc"></li><li class="subtoc"></li><li class="subtoc"><a class="navigation" href="index.html">Home</a></li><li class="subtoc"><a class="navigation" href="REF-CLASSES-ATTS.html">B Attribute Classes</a></li></ul></div><div><h3 class="oddSpec" id="att.datable.w3c">att.datable.w3c</h3><table class="wovenodd"><tr><td colspan="2" class="wovenodd-col2"><span class="label">att.datable.w3c</span> provides attributes for normalization of elements that contain datable events conforming to the W3C <span class="titlem">XML Schema Part 2: Datatypes Second Edition</span>. [<a class="link_ptr" href="CO.html#CONADA" title="Dates and Times"><span class="headingNumber">3.5.4 </span>Dates and Times</a> <a class="link_ptr" href="ND.html#NDDATE" title="Dates and Times"><span class="headingNumber">13.3.6 </span>Dates and Times</a>]</td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Module</span></td><td class="wovenodd-col2">tei — The TEI Infrastructure</td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Members</span></td><td class="wovenodd-col2"><span class="showmembers1"><a class="link_odd_classSpec" title="provides attributes for normalization of elements that contain dates, times, or datable events." href="ref-att.datable.html">att.datable</a><span class="showmembers2"> [<a class="link_odd_elementSpec" title="contains any descriptive or other information concerning the process by which a manuscript or manuscript part entered the holding institution." href="ref-acquisition.html">acquisition</a> <a class="link_odd_elementSpec" title="contains an informal description of a person's present or past affiliation with some organization, for example an employer or sponsor." href="ref-affiliation.html">affiliation</a> <a class="link_odd_elementSpec" title="specifies the age of a person." href="ref-age.html">age</a> <a class="link_odd_elementSpec" title="provides information about an application which has acted upon the document." href="ref-application.html">application</a> <a class="link_odd_elementSpec" title="contains a description of one binding, i.e. type of covering, boards, etc. applied to a manuscript." href="ref-binding.html">binding</a> <a class="link_odd_elementSpec" title="contains information about a person's birth, such as its date and place." href="ref-birth.html">birth</a> <a class="link_odd_elementSpec" title="contains the name of a geo-political unit consisting of two or more nation states or countries." href="ref-bloc.html">bloc</a> <a class="link_odd_elementSpec" title="documents a change or set of changes made during the production of a source document, or during the revision of an electronic file." href="ref-change.html">change</a> <a class="link_odd_elementSpec" title="contains information about the physical climate of a place." href="ref-climate.html">climate</a> <a class="link_odd_elementSpec" title="contains the name of a geo-political unit, such as a nation, country, colony, or commonwealth, larger than or administratively superior to a region and smaller than a bloc." href="ref-country.html">country</a> <a class="link_odd_elementSpec" title="contains information about the creation of a text." href="ref-creation.html">creation</a> <a class="link_odd_elementSpec" title="(custodial event) describes a single event during the custodial history of a manuscript." href="ref-custEvent.html">custEvent</a> <a class="link_odd_elementSpec" title="contains a date in any format." href="ref-date.html">date</a> <a class="link_odd_elementSpec" title="contains information about a person's death, such as its date and place." href="ref-death.html">death</a> <a class="link_odd_elementSpec" title="contains the name of any kind of subdivision of a settlement, such as a parish, ward, or other administrative or geographic unit." href="ref-district.html">district</a> <a class="link_odd_elementSpec" title="contains a description of the educational experience of a person." href="ref-education.html">education</a> <a class="link_odd_elementSpec" title="contains data relating to any kind of significant event associated with a person, place, or organization." href="ref-event.html">event</a> <a class="link_odd_elementSpec" title="specifies the faith, religion, or belief set of a person." href="ref-faith.html">faith</a> <a class="link_odd_elementSpec" title="contains information about a person's period of activity." href="ref-floruit.html">floruit</a> <a class="link_odd_elementSpec" title="(geographical feature name) contains a common noun identifying some geographical feature contained within a geographic name, such as valley, mount, etc." href="ref-geogFeat.html">geogFeat</a> <a class="link_odd_elementSpec" title="(geographical name) identifies a name associated with some geographical feature such as Windrush Valley or Mount Sinai." href="ref-geogName.html">geogName</a> <a class="link_odd_elementSpec" title="(identifier) supplies any form of identifier used to identify some object, such as a bibliographic item, a person, a title, an organization, etc. in a standardized way." href="ref-idno.html">idno</a> <a class="link_odd_elementSpec" title="(language knowledge) summarizes the state of a person's linguistic knowledge, either as prose or by a list of <langKnown> elements." href="ref-langKnowledge.html">langKnowledge</a> <a class="link_odd_elementSpec" title="(language known) summarizes the state of a person's linguistic competence, i.e., knowledge of a single language." href="ref-langKnown.html">langKnown</a> <a class="link_odd_elementSpec" title="contains information about a licence or other legal agreement applicable to the text." href="ref-licence.html">licence</a> <a class="link_odd_elementSpec" title="defines the location of a place as a set of geographical coordinates, in terms of other named geo-political entities, or as an address." href="ref-location.html">location</a> <a class="link_odd_elementSpec" title="(name, proper noun) contains a proper noun or noun phrase." href="ref-name.html">name</a> <a class="link_odd_elementSpec" title="contains an informal description of a person's present or past nationality or citizenship." href="ref-nationality.html">nationality</a> <a class="link_odd_elementSpec" title="contains an informal description of a person's trade, profession or occupation." href="ref-occupation.html">occupation</a> <a class="link_odd_elementSpec" title="marks that part of a relative temporal or spatial expression which indicates the direction of the offset between the two place names, dates, or times involved in the expression." href="ref-offset.html">offset</a> <a class="link_odd_elementSpec" title="(organization name) contains an organizational name." href="ref-orgName.html">orgName</a> <a class="link_odd_elementSpec" title="(origin date) contains any form of date, used to identify the date of origin for a manuscript or manuscript part." href="ref-origDate.html">origDate</a> <a class="link_odd_elementSpec" title="(origin place) contains any form of place name, used to identify the place of origin for a manuscript or manuscript part." href="ref-origPlace.html">origPlace</a> <a class="link_odd_elementSpec" title="contains any descriptive or other information concerning the origin of a manuscript or manuscript part." href="ref-origin.html">origin</a> <a class="link_odd_elementSpec" title="(personal name) contains a proper noun or proper-noun phrase referring to a person, possibly including one or more of the person's forenames, surnames, honorifics, added names, etc." href="ref-persName.html">persName</a> <a class="link_odd_elementSpec" title="contains an absolute or relative place name." href="ref-placeName.html">placeName</a> <a class="link_odd_elementSpec" title="contains information about the population of a place." href="ref-population.html">population</a> <a class="link_odd_elementSpec" title="indicates the numerical accuracy or precision associated with some aspect of the text markup." href="ref-precision.html">precision</a> <a class="link_odd_elementSpec" title="contains any descriptive or other information concerning a single identifiable episode during the history of a manuscript or manuscript part, after its creation but before its acquisition." href="ref-provenance.html">provenance</a> <a class="link_odd_elementSpec" title="contains the name of an administrative unit such as a state, province, or county, larger than a settlement, but smaller than a country." href="ref-region.html">region</a> <a class="link_odd_elementSpec" title="(relationship) describes any kind of relationship or linkage amongst a specified group of places, events, persons, objects or other items." href="ref-relation.html">relation</a> <a class="link_odd_elementSpec" title="describes a person's present or past places of residence." href="ref-residence.html">residence</a> <a class="link_odd_elementSpec" title="(responsibility) contains a phrase describing the nature of a person's intellectual responsibility, or an organization's role in the production or distribution of a work." href="ref-resp.html">resp</a> <a class="link_odd_elementSpec" title="contains a description of one seal or similar attachment applied to a manuscript." href="ref-seal.html">seal</a> <a class="link_odd_elementSpec" title="contains the name of a settlement such as a city, town, or village identified as a single geo-political or administrative unit." href="ref-settlement.html">settlement</a> <a class="link_odd_elementSpec" title="specifies the sex of a person." href="ref-sex.html">sex</a> <a class="link_odd_elementSpec" title="(socio-economic status) contains an informal description of a person's perceived social or economic status." href="ref-socecStatus.html">socecStatus</a> <a class="link_odd_elementSpec" title="contains a word or phrase describing a stamp or similar device." href="ref-stamp.html">stamp</a> <a class="link_odd_elementSpec" title="contains a description of some status or quality attributed to a person, place, or organization often at some specific time or for a specific date range." href="ref-state.html">state</a> <a class="link_odd_elementSpec" title="contains information about the physical terrain of a place." href="ref-terrain.html">terrain</a> <a class="link_odd_elementSpec" title="contains a phrase defining a time of day in any format." href="ref-time.html">time</a> <a class="link_odd_elementSpec" title="contains a title for any kind of work." href="ref-title.html">title</a> <a class="link_odd_elementSpec" title="contains a description of some status or quality attributed to a person, place, or organization typically, but not necessarily, independent of the volition or action of the holder and usually not at some specific time or for a specific date range." href="ref-trait.html">trait</a>] </span></span></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Attributes</span></td><td class="wovenodd-col2">Attributes<table class="attList"><tr><td class="odd_label">when<span class="bookmarklink"><a class="bookmarklink" id="tei_att.when" href="#tei_att.when" title="link to this attribute "><span class="invisible"> when</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">supplies the value of the date or time in a standard form, e.g. yyyy-mm-dd.<table class="attDef"><tr><td class="odd_label"><span class="label" lang="en">Status</span> </td><td class="odd_value"><span lang="en">Optional</span></td></tr><tr><td class="odd_label"><span lang="en" class="label">Datatype</span> </td><td class="odd_value"><a class="link_element" href="ref-teidata.temporal.w3c.html">teidata.temporal.w3c</a></td></tr><tr><td colspan="2"><p>Examples of W3C date, time, and date & time formats.</p><div id="index-egXML-d52e5776" class="pre egXML_valid"><span class="element"><p></span><br /> <span class="element"><date <span class="attribute">when</span>="<span class="attributevalue">1945-10-24</span>"></span>24 Oct 45<span class="element"></date></span><br /> <span class="element"><date <span class="attribute">when</span>="<span class="attributevalue">1996-09-24T07:25:00Z</span>"></span>September 24th, 1996 at 3:25 in the morning<span class="element"></date></span><br /> <span class="element"><time <span class="attribute">when</span>="<span class="attributevalue">1999-01-04T20:42:00-05:00</span>"></span>Jan 4 1999 at 8 pm<span class="element"></time></span><br /> <span class="element"><time <span class="attribute">when</span>="<span class="attributevalue">14:12:38</span>"></span>fourteen twelve and 38 seconds<span class="element"></time></span><br /> <span class="element"><date <span class="attribute">when</span>="<span class="attributevalue">1962-10</span>"></span>October of 1962<span class="element"></date></span><br /> <span class="element"><date <span class="attribute">when</span>="<span class="attributevalue">--06-12</span>"></span>June 12th<span class="element"></date></span><br /> <span class="element"><date <span class="attribute">when</span>="<span class="attributevalue">---01</span>"></span>the first of the month<span class="element"></date></span><br /> <span class="element"><date <span class="attribute">when</span>="<span class="attributevalue">--08</span>"></span>August<span class="element"></date></span><br /> <span class="element"><date <span class="attribute">when</span>="<span class="attributevalue">2006</span>"></span>MMVI<span class="element"></date></span><br /> <span class="element"><date <span class="attribute">when</span>="<span class="attributevalue">0056</span>"></span>AD 56<span class="element"></date></span><br /> <span class="element"><date <span class="attribute">when</span>="<span class="attributevalue">-0056</span>"></span>56 BC<span class="element"></date></span><br /><span class="element"></p></span></div></td></tr><tr><td colspan="2"><div id="index-egXML-d52e5835" class="pre egXML_valid">This list begins in<br /> the year 1632, more precisely on Trinity Sunday, i.e. the Sunday after<br /> Pentecost, in that year the<br /><span class="element"><date <span class="attribute">calendar</span>="<span class="attributevalue">#julian</span>" <span class="attribute">when</span>="<span class="attributevalue">1632-06-06</span>"></span>27th of May (old style)<span class="element"></date></span>.</div></td></tr><tr><td colspan="2"><div id="index-egXML-d52e5842" class="pre egXML_valid"><span class="element"><opener></span><br /> <span class="element"><dateline></span><br /> <span class="element"><placeName></span>Dorchester, Village,<span class="element"></placeName></span><br /> <span class="element"><date <span class="attribute">when</span>="<span class="attributevalue">1828-03-02</span>"></span>March 2d. 1828.<span class="element"></date></span><br /> <span class="element"></dateline></span><br /> <span class="element"><salute></span>To<br /> Mrs. Cornell,<span class="element"></salute></span> Sunday <span class="element"><time <span class="attribute">when</span>="<span class="attributevalue">12:00:00</span>"></span>noon.<span class="element"></time></span><span class="element"></opener></span></div></td></tr></table></td></tr><tr><td class="odd_label">notBefore<span class="bookmarklink"><a class="bookmarklink" id="tei_att.notBefore" href="#tei_att.notBefore" title="link to this attribute "><span class="invisible"> notBefore</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">specifies the earliest possible date for the event in standard form, e.g. yyyy-mm-dd.<table class="attDef"><tr><td class="odd_label"><span class="label" lang="en">Status</span> </td><td class="odd_value"><span lang="en">Optional</span></td></tr><tr><td class="odd_label"><span lang="en" class="label">Datatype</span> </td><td class="odd_value"><a class="link_element" href="ref-teidata.temporal.w3c.html">teidata.temporal.w3c</a></td></tr></table></td></tr><tr><td class="odd_label">notAfter<span class="bookmarklink"><a class="bookmarklink" id="tei_att.notAfter" href="#tei_att.notAfter" title="link to this attribute "><span class="invisible"> notAfter</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">specifies the latest possible date for the event in standard form, e.g. yyyy-mm-dd.<table class="attDef"><tr><td class="odd_label"><span class="label" lang="en">Status</span> </td><td class="odd_value"><span lang="en">Optional</span></td></tr><tr><td class="odd_label"><span lang="en" class="label">Datatype</span> </td><td class="odd_value"><a class="link_element" href="ref-teidata.temporal.w3c.html">teidata.temporal.w3c</a></td></tr></table></td></tr><tr><td class="odd_label">from<span class="bookmarklink"><a class="bookmarklink" id="tei_att.from" href="#tei_att.from" title="link to this attribute "><span class="invisible"> from</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">indicates the starting point of the period in standard form, e.g. yyyy-mm-dd.<table class="attDef"><tr><td class="odd_label"><span class="label" lang="en">Status</span> </td><td class="odd_value"><span lang="en">Optional</span></td></tr><tr><td class="odd_label"><span lang="en" class="label">Datatype</span> </td><td class="odd_value"><a class="link_element" href="ref-teidata.temporal.w3c.html">teidata.temporal.w3c</a></td></tr></table></td></tr><tr><td class="odd_label">to<span class="bookmarklink"><a class="bookmarklink" id="tei_att.to" href="#tei_att.to" title="link to this attribute "><span class="invisible"> to</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">indicates the ending point of the period in standard form, e.g. yyyy-mm-dd.<table class="attDef"><tr><td class="odd_label"><span class="label" lang="en">Status</span> </td><td class="odd_value"><span lang="en">Optional</span></td></tr><tr><td class="odd_label"><span lang="en" class="label">Datatype</span> </td><td class="odd_value"><a class="link_element" href="ref-teidata.temporal.w3c.html">teidata.temporal.w3c</a></td></tr></table></td></tr></table></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Schematron</span></td><td class="wovenodd-col2"><div xml:space="preserve" class="pre"><br /><span class="element"><sch:rule <span class="attribute">context</span>="<span class="attributevalue">tei:*[@when]</span>"></span><br /><span class="element"><sch:report <span class="attribute">test</span>="<span class="attributevalue">@notBefore|@notAfter|@from|@to</span>"<br /> <span class="attribute">role</span>="<span class="attributevalue">nonfatal</span>"></span>The @when attribute cannot be used with any other att.datable.w3c attributes.<span class="element"></sch:report></span><br /><span class="element"></sch:rule></span></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Schematron</span></td><td class="wovenodd-col2"><div xml:space="preserve" class="pre"><br /><span class="element"><sch:rule <span class="attribute">context</span>="<span class="attributevalue">tei:*[@from]</span>"></span><br /><span class="element"><sch:report <span class="attribute">test</span>="<span class="attributevalue">@notBefore</span>"<br /> <span class="attribute">role</span>="<span class="attributevalue">nonfatal</span>"></span>The @from and @notBefore attributes cannot be used together.<span class="element"></sch:report></span><br /><span class="element"></sch:rule></span></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Schematron</span></td><td class="wovenodd-col2"><div xml:space="preserve" class="pre"><br /><span class="element"><sch:rule <span class="attribute">context</span>="<span class="attributevalue">tei:*[@to]</span>"></span><br /><span class="element"><sch:report <span class="attribute">test</span>="<span class="attributevalue">@notAfter</span>"<br /> <span class="attribute">role</span>="<span class="attributevalue">nonfatal</span>"></span>The @to and @notAfter attributes cannot be used together.<span class="element"></sch:report></span><br /><span class="element"></sch:rule></span></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Example</span></td><td class="wovenodd-col2"><div id="index-egXML-d52e5924" class="pre egXML_valid"><span class="element"><date <span class="attribute">from</span>="<span class="attributevalue">1863-05-28</span>" <span class="attribute">to</span>="<span class="attributevalue">1863-06-01</span>"></span>28 May through 1 June 1863<span class="element"></date></span></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p>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 <span class="titlem">XML Schema Part 2: Datatypes Second Edition</span>, using the Gregorian calendar.</p><p>The most commonly-encountered format for the date portion of a temporal attribute is <code>yyyy-mm-dd</code>, but <code>yyyy</code>, <code>--mm</code>, <code>---dd</code>, <code>yyyy-mm</code>, or <code>--mm-dd</code> may also be used. For the time part, the form <code>hh:mm:ss</code> is used.</p><p>Note that this format does not currently permit use of the value <span class="val">0000</span> to represent the year 1 BCE; instead the value <span class="val">-0001</span> should be used.</p></td></tr></table></div></div><div class="stdfooter autogenerated"><p>
[<a href="../../en/html/ref-att.datable.w3c.html">English</a>]
[<a href="../../de/html/ref-att.datable.w3c.html">Deutsch</a>]
[<a href="../../es/html/ref-att.datable.w3c.html">Español</a>]
[<a href="../../it/html/ref-att.datable.w3c.html">Italiano</a>]
[<a href="../../fr/html/ref-att.datable.w3c.html">Français</a>]
[<a href="../../ja/html/ref-att.datable.w3c.html">日本語</a>]
[<a href="../../ko/html/ref-att.datable.w3c.html">한국어</a>]
[<a href="../../zh-TW/html/ref-att.datable.w3c.html">中文</a>]
</p><hr /><div class="footer"><a class="plain" href="http://www.tei-c.org/About/">TEI Consortium</a> | <a class="plain" href="http://www.tei-c.org/About/contact.xml">Feedback</a></div><hr /><address><br />TEI Guidelines <a class="link_ref" href="AB.html#ABTEI4">Version</a> <a class="link_ref" href="../../readme-3.1.1.html">3.1.1a</a>. Last updated on <span class="date">10th May 2017</span>, revision <a class="link_ref" href="https://github.com/TEIC/TEI/commit/bd8dda3">bd8dda3</a>. This page generated on 2017-05-12T12:30:09Z.</address></div></body></html>