https://github.com/TEIC/TEI
Raw File
Tip revision: 347c64fac3fa1a64ade0d8d1842813d4b8f7acec authored by Hugh Cayless on 12 May 2017, 16:57:59 UTC
Updates.
Tip revision: 347c64f
ref-att.datable.iso.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.iso </title><meta property="Language" content="en" /><meta property="DC.Title" content="TEI class att.datable.iso " /><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.iso">att.datable.iso</h3><table class="wovenodd"><tr><td colspan="2" class="wovenodd-col2"><span class="label">att.datable.iso</span> provides attributes for normalization of elements that contain datable events using the ISO 8601 standard. [<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">namesdates — Names, Dates, People, and Places</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 &lt;langKnown&gt; 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-iso<span class="bookmarklink"><a class="bookmarklink" id="tei_att.when-iso" href="#tei_att.when-iso" title="link to this attribute "><span class="invisible"> when-iso</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">supplies the value of a date or time in a standard form.<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.iso.html">teidata.temporal.iso</a></td></tr><tr><td colspan="2"><p>The following are examples of ISO date, time, and date &amp; time formats that are <em>not</em> valid W3C format normalizations.</p><div id="index-egXML-d52e112458" class="pre egXML_valid"><span class="element">&lt;date <span class="attribute">when-iso</span>="<span class="attributevalue">1996-09-24T07:25+00</span>"&gt;</span>Sept. 24th, 1996 at 3:25 in the morning<span class="element">&lt;/date&gt;</span><br /><span class="element">&lt;date <span class="attribute">when-iso</span>="<span class="attributevalue">1996-09-24T03:25-04</span>"&gt;</span>Sept. 24th, 1996 at 3:25 in the morning<span class="element">&lt;/date&gt;</span><br /><span class="element">&lt;time <span class="attribute">when-iso</span>="<span class="attributevalue">1999-01-04T20:42-05</span>"&gt;</span>4 Jan 1999 at 8:42 pm<span class="element">&lt;/time&gt;</span><br /><span class="element">&lt;time <span class="attribute">when-iso</span>="<span class="attributevalue">1999-W01-1T20,70-05</span>"&gt;</span>4 Jan 1999 at 8:42 pm<span class="element">&lt;/time&gt;</span><br /><span class="element">&lt;date <span class="attribute">when-iso</span>="<span class="attributevalue">2006-05-18T10:03</span>"&gt;</span>a few minutes after ten in the morning on Thu 18 May<span class="element">&lt;/date&gt;</span><br /><span class="element">&lt;time <span class="attribute">when-iso</span>="<span class="attributevalue">03:00</span>"&gt;</span>3 A.M.<span class="element">&lt;/time&gt;</span><br /><span class="element">&lt;time <span class="attribute">when-iso</span>="<span class="attributevalue">14</span>"&gt;</span>around two<span class="element">&lt;/time&gt;</span><br /><span class="element">&lt;time <span class="attribute">when-iso</span>="<span class="attributevalue">15,5</span>"&gt;</span>half past three<span class="element">&lt;/time&gt;</span></div><p>All of the examples of the <span class="att">when</span> attribute in the <a class="link_odd" title="provides attributes for normalization of elements that contain datable events conforming to the W3C _XML_Schema_Part_2:_Datatypes_Second_Edition_." href="ref-att.datable.w3c.html">att.datable.w3c</a> class are also valid with respect to this attribute.</p></td></tr><tr><td colspan="2"><div id="index-egXML-d52e112539" class="pre egXML_valid">He likes to be punctual. I said <span class="element">&lt;q&gt;</span><br /> <span class="element">&lt;time <span class="attribute">when-iso</span>="<span class="attributevalue">12</span>"&gt;</span>around noon<span class="element">&lt;/time&gt;</span><br /><span class="element">&lt;/q&gt;</span>, and he showed up at <span class="element">&lt;time <span class="attribute">when-iso</span>="<span class="attributevalue">12:00:00</span>"&gt;</span>12 O'clock<span class="element">&lt;/time&gt;</span> on the dot.</div><p>The second occurence of <a class="gi" title="contains a phrase defining a time of day in any format." href="ref-time.html">time</a> could have been encoded with the <span class="att">when</span> attribute, as <span class="val">12:00:00</span> is a valid time with respect to the W3C <span class="titlem">XML Schema Part 2: Datatypes Second Edition</span> specification. The first occurence could not.</p></td></tr></table></td></tr><tr><td class="odd_label">notBefore-iso<span class="bookmarklink"><a class="bookmarklink" id="tei_att.notBefore-iso" href="#tei_att.notBefore-iso" title="link to this attribute "><span class="invisible"> notBefore-iso</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.iso.html">teidata.temporal.iso</a></td></tr></table></td></tr><tr><td class="odd_label">notAfter-iso<span class="bookmarklink"><a class="bookmarklink" id="tei_att.notAfter-iso" href="#tei_att.notAfter-iso" title="link to this attribute "><span class="invisible"> notAfter-iso</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.iso.html">teidata.temporal.iso</a></td></tr></table></td></tr><tr><td class="odd_label">from-iso<span class="bookmarklink"><a class="bookmarklink" id="tei_att.from-iso" href="#tei_att.from-iso" title="link to this attribute "><span class="invisible"> from-iso</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">indicates the starting point of the period in standard form.<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.iso.html">teidata.temporal.iso</a></td></tr></table></td></tr><tr><td class="odd_label">to-iso<span class="bookmarklink"><a class="bookmarklink" id="tei_att.to-iso" href="#tei_att.to-iso" title="link to this attribute "><span class="invisible"> to-iso</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">indicates the ending point of the period in standard form.<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.iso.html">teidata.temporal.iso</a></td></tr></table></td></tr></table></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 &amp; time intended, in any of the standard formats specified by ISO 8601, using the Gregorian calendar.</p></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><div class="p">If both <span class="att">when-iso</span> and <span class="att">dur-iso</span> are specified, the values should be interpreted as indicating a span of time by its starting time (or date) and duration. That is, <div id="index-egXML-d52e112669" class="pre egXML_valid"><span class="element">&lt;date <span class="attribute">when-iso</span>="<span class="attributevalue">2007-06-01</span>" <span class="attribute">dur-iso</span>="<span class="attributevalue">P8D</span>"/&gt;</span></div> indicates the same time period as <div id="index-egXML-d52e112672" class="pre egXML_valid"><span class="element">&lt;date <span class="attribute">when-iso</span>="<span class="attributevalue">2007-06-01/P8D</span>"/&gt;</span></div></div><p>In providing a ‘regularized’ form, no claim is made that the form in the source text is incorrect; the regularized form is simply that chosen as the main form for purposes of unifying variant forms under a single heading.</p></td></tr></table></div></div><div class="stdfooter autogenerated"><p>
    [<a href="../../en/html/ref-att.datable.iso.html">English</a>]
    [<a href="../../de/html/ref-att.datable.iso.html">Deutsch</a>]
    [<a href="../../es/html/ref-att.datable.iso.html">Español</a>]
    [<a href="../../it/html/ref-att.datable.iso.html">Italiano</a>]
    [<a href="../../fr/html/ref-att.datable.iso.html">Français</a>]
    [<a href="../../ja/html/ref-att.datable.iso.html">日本語</a>]
    [<a href="../../ko/html/ref-att.datable.iso.html">한국어</a>]
    [<a href="../../zh-TW/html/ref-att.datable.iso.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>
back to top