<date>

Date

Container element for the parts of a single calendar date.

Remarks

Usage: A <date> element may contain date components such as <day>, <month>, and <year> (which are typically given numeric values), as well as non-numeric elements such as <season> (which is a text string).

When used within citations (<element-citation> and <mixed-citation>), this element names the publication date of the cited source.

Related Essay: For a discussion on the use of <date>, see Dates in Citations.

Attributes

calendar Calendar
date-type Type of Date
id Document Internal Identifier
iso-8601-date ISO-8601 Formatted Date
publication-format Format of Publication
specific-use Specific Use
xml:base Base

Related Elements

Within citations (<element-citation> and <mixed-citation>), this element is used to name the date of publication of the cited source. The elements <year>, <date>, <day>, <month>, and <season> may all be used to describe the date a cited resource was published. Other dates inside a citation, such as a copyright date, the date on which the author accessed the resource, or a withdrawal date, should be tagged using <date-in-citation> with the @content-type attribute used to name the type of date (copyright, access-date, time-stamp, etc.).

Content Model

<!ELEMENT  date         %date-model;                                 >

Expanded Content Model

(((day?, month?) | season)?, year?, era?, string-date?)

Description

The following, in order:

This element may be contained in:

<element-citation>, <event>, <event-desc>, <mixed-citation>, <product>, <pub-history>, <related-article>, <related-object>

Example 1

Date approved:


...
<book-part-meta>
...
<contrib-group>
<contrib contrib-type="author">
<collab collab-type="committee">Technical Committee ISO/TC 108, 
Subcommittee SC 2</collab>
</contrib>
</contrib-group>
<fpage seq="1">1</fpage>
<lpage>23</lpage>
<pub-history>
<date date-type="approved">
<day>01</day>
<month>06</month>
<year>2012</year>
</date>
</pub-history>
...
</book-part-meta>
...

Example 2

In metadata, in both publication date and publication history dates:

    
...
<book-meta>
...
<pub-date  date-type="publication" 
  publication-format="electronic" 
  iso-8601-date="1998-09-17">
<day>17</day><month>09</month><year>1998</year>
</pub-date>
<pub-date date-type="publication" 
  publication-format="print" 
  iso-8601-date="1998-11-09">
<year>1998</year>
</pub-date>
<pub-history>
<date date-type="received" 
  publication-format="manuscript" 
  iso-8601-date="1998-01-05">
<day>05</day><month>01</month><year>1998</year>
</date>
<date date-type="rev-request" 
  iso-8601-date="1998-03-14">
<day>14</day><month>03</month><year>1998</year>
</date>
<date date-type="rev-received" 
  iso-8601-date="1998-05-24">
<day>24</day><month>05</month><year>1998</year>
</date>
<date date-type="accepted" 
  iso-8601-date="1998-06-06">
<day>06</day><month>06</month><year>1998</year>
</date>
</pub-history>
...
</book-meta>
...

   

...
<book-meta>
<book-title-group>
<book-title>Proceedings of Balisage: The Markup Conference 
2013</book-title>
</book-title-group>
<pub-date iso-8601-date="2013-10">
<month>October</month><year>2013</year></pub-date>
<book-volume-number>10</book-volume-number>
<isbn content-type="isbn-13">978-1-935958-06-2</isbn>
<publisher>
<publisher-name>Mulberry Technologies, Inc.</publisher-name>
</publisher>
<pub-history>
<event>
<event-desc>pre-conference proceedings</event-desc>
<date iso-8601-date="2013-07" date-type="pub" 
publication-format="online">
<month>July</month><year>2013</year></date>
</event>
<event>
<event-desc>post-conference proceedings</event-desc>
<date iso-8601-date="2013-10" date-type="pub" 
publication-format="online">
<month>October</month><year>2013</year></date>
</event>
</pub-history>
...
</book-meta>
...

Example 3

Date in a non-Gregorian calendar:

...
<date date-type="received" calendar="Japanese" 
  iso-8601-date="1947-07-01">
<day>1</day>
<month>7</month>
<year>22</year>
<era>昭和</era>
</date>
...

Example 4

Date used as a time stamp:


...
<date date-type="online" specific-use="metadata">
<string-date>2012-05-03T08:47:08</string-date>
</date>
...

Example 5

Inside a citation to hold the publication date of the cited book:


...
<ref id="B14">
<element-citation publication-type="book" publication-format="print">
<person-group person-group-type="author">
<name><surname>Hart</surname>
<given-names>JT</given-names></name>
</person-group>
<source>A new kind of doctor: the general practitioner&rsquo;s 
part in the health of the community</source>
<date iso-8601-date="1988" date-type="published">
<year>1988</year></date>
<publisher-loc>London</publisher-loc>
<publisher-name>Merlin Press</publisher-name>
</element-citation>
</ref>
...


...
<ref id="B14">
<mixed-citation publication-type="book" publication-format="print">
<person-group person-group-type="author">
<name><surname>Hart</surname> <given-names>JT</given-names>
</name></person-group>. 
<source>A new kind of doctor: the general practitioner&rsquo;s 
part in the health of the community</source>. 
<publisher-loc>London</publisher-loc>:  
<publisher-name>Merlin Press</publisher-name>, 
<date iso-8601-date="1988" date-type="published">
<year>1988</year></date>.
</mixed-citation>
</ref>
...