DDI Controlled Vocabulary for Date Type


Specifies the type of date


The present list is based on ISO 8601 usage.


Short Name:
Long Name:
Date Type
Version Notes:
Canonical URI:
Canonical URI of this version:
Location URI:
Alternate format location URI:
Alternate format location URI:
Agency Name:
DDI Alliance

Code List
Value of the Code Descriptive Term of the Code Definition of the Code
DateTime DateTime Integer-valued year, month, day, hour and minute, plus decimal-valued second property, and time zone hour and minute (e.g., 2002-10-10T12:00:00-05:00). A time datatype corresponding to the W3C XML Schema's xs:dateTime datatype.
Time Time Left-truncated dateTime, e.g., 13:20:00-05:00 (1:20 pm for Eastern Standard Time U.S.) A time datatype corresponding to the W3C XML Schema's xs:time datatype.
Date Date Integer-valued year, month, day, and time zone hour and minutes, e.g., 2003-06-30-05:00 (30 June 2003 Eastern Standard Time U.S.). A time datatype corresponding to the W3C XML Schema's xs:date datatype.
GYearMonth YearMonth Integer-valued year and month, e.g., 2004-11. A time datatype corresponding to the W3C XML Schema's xs:gYearMonth datatype.
GYear Year Integer-valued year, e.g., 2005. A time datatype corresponding to the W3C XML Schema's xs:gYear datatype.
GMonthDay MonthDay Integer-valued month and day, e.g., 12-31. A time datatype corresponding to the W3C XML Schema's xs:gMonthDay datatype.
GDay Day Integer-valued day, e.g., 24. A time datatype corresponding to the W3C XML Schema's xs:gDay datatype.
GMonth Month Integer-valued month. The lexical representation for gMonth is the left and right truncated lexical representation for date: --MM, e.g., 03. An optional following time zone qualifier is allowed as for date. No preceding sign is allowed. No other formats are allowed. A time datatype corresponding to the W3C XML Schema's xs:gMonth datatype.
Duration Duration A duration of time. The value space of "duration" is a six-dimensional space in which the coordinates designate the Gregorian year, month, day, hour, minute, and second components as defined in ISO 8601. These components are ordered in their significance by their order of appearance as year, month, day, hour, minute, and second. The lexical representation of duration is the extended format PnYnMnDTnHnMnS, where P is the flag for duration (i.e., Period) and is constant, nY represents the number of years, nM the number of months, nD the number of days, T is the date/time separator, nH the number of hours, nM the number of minutes and nS the number of seconds. The number of seconds can include decimal digits to arbitrary precision. For example, to indicate a duration of 1 year, 2 months, 3 days, 10 hours, and 30 minutes, one would write: "P1Y2M3DT10H30M". An optional preceding minus sign ("-") is allowed, to indicate a negative duration: a duration of minus 120 days would be indicated as: "-P120D". A time datatype corresponding to the W3C XML Schema's xs:duration datatype.
Timespan Timespan Complex structure containing start/end, start/duration, or duration/end. "Start" and "end" can follow any of the designated DateTime structures and should be declared in a fixed format. Examples: start/end: "2007-03-01T13:00:00/2008-05-11T15:30:00"; start/duration: "2007-03-01T13:00:00/P1Y2M10DT2H30M"; duration/end: "P1Y2M10DT2H30M/2008-05-11T15:30:00". For start/end expressions, if any elment is missing from the end value, it is assumed to be the same as for the start value, including the time zone if used. For example a 2 hour meeting would be represented thusly: "2007-12-14T13:30/15:30". Note that this is not allowed as a date type in the description of an NCube, because the latter represents two or more dimensions.
Other Other Use if the date type is known, but not found in the list.


This is a standard XML date type code and supports the use of an external controlled vocabulary. Examples are date, dateTime, gYearMonth, gYear, and duration.

Module Name Element Name
reusable DateTypeCode

For the category attribute, a value from a controlled vocabulary may be provided if the "other" value is chosen. In this case, the term from the controlled vocabulary should be placed in the "othercategory" attribute, and the controlledVocabUsed element (in the Document Description section) should also be filled in.

Element Number in DDI 2.1 Element/Attribute Name
4.3.23 varFormat@category

Copyright and License

Copyright © DDI Alliance 2014.

Creative Commons Attribution-ShareAlike 3  This work is licensed under a Creative Commons Attribution-ShareAlike 3.

Page generated by gc_ddi-cv2html.xslt.