by Eric van der Vlist is published by O'Reilly & Associates (ISBN: 0596004214)


Name

xsd:dateTime — Instant of time (Gregorian calendar)

Synopsis

<xsd:simpleType name="dateTime" id="dateTime">
 <xsd:restriction base="xsd:anySimpleType">
 <xsd:whiteSpace value="collapse" fixed="true"/>
 </xsd:restriction>
</xsd:simpleType>

Derived from

xsd:anySimpleType

Primary

xsd:dateTime

Known subtypes

None

Data parameters (facets)

enumeration, maxExclusive, maxInclusive, minExclusive, minInclusive, pattern.

Description

This datatype describes instances identified by the combination of a date and a time. Its value space is described as a combination of date and time of day in Chapter 5.4 of ISO 8601. Its lexical space is the extended format:

 [-]CCYY-MM-DDThh:mm:ss[Z|(+|-)hh:mm]

The time zone may be specified as Z (UTC) or (+|-)hh:mm. Time zones that aren't specified are considered undetermined.

Restrictions

The basic format of ISO 8601 calendar datetimes, CCYYMMDDThhmmss, isn't supported.

The other forms of date-times available in ISO 8601—ordinal dates defined by the year, the number of the day in the year, dates identified by calendar week, and day numbers—aren't supported.

As the value space is defined by reference to ISO 8601, there is no support for any calendar system other than Gregorian. As the lexical space is also defined in reference to ISO 8601, there is no support for any localization such as different orders for date parts or named months.

The order relation between date-times with and without time zone is partial: they can be compared only outside of a +/- 14 hours interval.

Example

Valid values for xsd:dateTime include: 2001-10-26T21:32:52, 2001-10-26T21:32:52+02:00, 2001-10-26T19:32:52Z, 2001-10-26T19:32:52+00:00, -2001-10-26T21:32:52, or 2001-10-26T21:32:52.12679.

The following values are invalid: 2001-10-26 (all the parts must be specified), 2001-10-26T21:32 (all the parts must be specified), 2001-10-26T25:32:52+02:00 (the hours part—25—is out of range), or 01-10-26T21:32 (all the parts must be specified).


This text is released under the Free Software Foundation GFDL.