# EXSLT - date:date-format - Implementer Page

Version: 1 Status: new User Page: index.html XML Definition: date.date-format.xml Element Package: date.date-format.zip #### Element Syntax
    <date:date-format
       name = qname
       calendar = "gregorian" | qname-but-not-ncname
       lang = language
       first-day-of-week = "sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | string />
The `date:date-format` element declares a `date format`, which controls the interpretation of a format pattern used by the `date:format-date` and `date:parse-date` functions. If there is a `name` attribute, then the element declares a named date format; otherwise, it declares the default date format. The value of the `name` attribute is a QName, which is expanded as described in [2.4 Qualified Names] of [XSLT]. It is an error to declare either the default date format or a date format with a given name more than once (even with different import precedence), unless it is declared every time with the same value for all attributes (taking into account any default values). The `calendar` attribute specifies the calendar used to interpret format strings using the date format. The value must be a QName. If the QName does not have a prefix, then it identifies calendar specified in this document and must be `gregorian`. If the QName has a prefix, then the QName is expanded into an expanded-name as described in [2.4 Qualified Names] of [XSLT]; the expanded-name identifies the calendar; the interpretation of the format pattern used in the `date:format-date` and `date:parse-date` functions in this case is not specified by this document. If the processor does not support the calendar used by the date format used in these functions, the result of these functions is an empty string (`''`). If there is no `calendar` attribute or it has the value `gregorian`, then the date/time being processed is interpreted as using the Gregorian calendar, with the same assumptions as made by the JDK 1.1 GregorianCalendar class. If this date format is used by the `date:format-date` or `date:parse-date` function, then the format pattern strings that they use must be in the syntax specified by the JDK 1.1 SimpleDateFormat class. The format pattern string is interpreted as described for the JDK 1.1 SimpleDateFormat class. The `lang` attribute specifies the language of the strings used in formatting the date; it has the same range of values as xml:lang [XML]; if no `lang` value is specified or if the processor does not support the specified language, the language should be determined from the system environment. The `first-day-in-week` attribute specifies the day that's used as the first day of the week for calculating numbers of the week in month, week in year and day in week. If the calendar is Gregorian, then it must be one of the strings `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday` or `saturday`. Otherwise the values are restricted based on the calendar being used for the date format. An implementation of this extension element in the EXSLT date namespace must conform to the behaviour described in this document. ## Implementations No XSLT processors that we know of have built-in support for `date:date-format`. There are currently no third-party implementations of `date:date-format`. ## Change History Submitted: 2001-05-13 Creator: Jeni Tennison(http://www.jenitennison.com/) Defines a date format used to interpret a format pattern within `format-date` and `date:parse-date`.

http://www.exslt.org/date/elements/date-format/date.date-format.html last modified 2001-05-13