EXSLT - date:format-date - Implementer Page

Version: 2
Status: implemented
User Page: index.html
XML Definition: date.format-date.xml
Function Package: date.format-date.zip

Function Syntax

string date:format-date(string, string)

Template Syntax

<xsl:call-template name="date:format-date">
   <xsl:with-param name="date-time" select="string" />
   <xsl:with-param name="pattern" select="string" />
</xsl:call-template>

The date:format-date function formats a date/time according to a pattern.

The first argument to date:format-date specifies the date/time to be formatted. It must be right or left-truncated date/time strings in one of the formats defined in [XML Schema Part 2: Datatypes]. The permitted formats are as follows:

xs:dateTime (CCYY-MM-DDThh:mm:ss)
xs:date (CCYY-MM-DD)
xs:time (hh:mm:ss)
xs:gYearMonth (CCYY-MM)
xs:gYear (CCYY)
xs:gMonthDay (--MM-DD)
xs:gMonth (--MM--)
xs:gDay (---DD)

The second argument is a string that gives the format pattern used to format the date. The format pattern 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.

If the date/time format is right-truncated (i.e. in a format other than xs:time, or xs:dateTime) then any missing components are assumed to be as follows: if no month is specified, it is given a month of 01; if no day is specified, it is given a day of 01; if no time is specified, it is given a time of 00:00:00.

If the date/time format is left-truncated (i.e. xs:time, xs:gMonthDay, xs:gMonth or xs:gDay) and the format pattern has a token that uses a component that is missing from the date/time format used, then that token is replaced with an empty string ('') within the result.

An implementation of this extension function 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:format-date.

The following implementations of date:format-date are available:

Language	Implemented Version	Creator	Date	Download
Javascript	2	Chris Bayes	2001-06-11	date.js
Msxsl	2	Chris Bayes	2001-06-16	date.msxsl.xsl
EXSLT Function	2	Jeni Tennison	2001-06-07	date.format-date.function.xsl
XSLT Template	2	Jeni Tennison	2001-06-07	date.format-date.template.xsl

Change History

Previous Version: date.format-date.1.html

Version	Modified	By	Details
2	2001-06-07	Jeni Tennison	Removed third (optional date format) argument.
2.1	2001-06-11	Jeni Tennison	Added Javascript implementation.
2.2	2001-06-16	Jeni Tennison	Updated Javascript implementation. Added Microsoft-specific stylesheet.
2.3	2001-08-10	Jeni Tennison	Added XSLT template and EXSLT - Functions implementation.