This work is licensed under a Creative Commons Attribution-ShareAlike 3.Specifies the type of date
| 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 © DDI Alliance 2014.
This work is licensed under a Creative Commons Attribution-ShareAlike 3.
Page generated by gc_ddi-cv2html.xslt.