EXSLT - date:time - Implementer Page

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

Function Syntax

string date:time(string?)

Template Syntax

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

The date:time function returns the time specified in the date/time string given as the argument. If no argument is given, then the current local date/time, as returned by date:date-time is used as a default argument.

The date/time string specified as an argument must be a string in a format matching the lexical representation of either xs:dateTime in [3.2.7 dateTime] or xs:time in [3.2.8 time] of [XML Schema Part 2: Datatypes]. If the argument string is not in this format, date:time returns an empty string ('').

The date/time format is basically CCYY-MM-DDThh:mm:ss, although implementers should consult [XML Schema Part 2: Datatypes] and [ISO 8601] for details.

The date is returned as a string with a lexical representation as defined for xs:time in [3.2.8 time] of [XML Schema Part 2: Datatypes].

The time format is basically hh:mm:ss, although implementers should consult [XML Schema Part 2: Datatypes] and [ISO 8601] for details.

If no argument is given or the argument date/time specifies a time zone, then the time string format must include a time zone, either a Z to indicate Coordinated Universal Time or a + or - followed by the difference between the difference from UTC represented as hh:mm. If an argument is specified and it does not specify a time zone, then the time string format must not include a time zone.

An implementation of this extension function in the EXSLT date namespace must conform to the behaviour described in this document.


Built-in support for date:time is available in the following XSLT processors:

ProcessorProcessor VersionImplemented Version
SAXON from Michael Kay6.4.22
Xalan-J from Apache2.4.D12
4XSLT, from 4Suite.0.12.0a32
libxslt from Daniel Veillard et al.1.0.192

The following implementations of date:time are available:

LanguageImplemented VersionCreatorDateDownload
EXSLT Function2Jeni Tennison2001-06-11date.time.function.xsl
XSLT Template2Jeni Tennison2001-06-11date.time.template.xsl
Javascript2Chris Bayes2001-06-11date.js
Msxsl2Chris Bayes2001-06-16date.msxsl.xsl

Change History

Previous Version: date.time.1.html

22001-06-11Jeni Tennison
  • Added xs:time format as a legal date/time format for the argument to this function.
  • Added implementations in Javascript, XSLT and EXSLT - Functions.
2.12001-06-16Jeni Tennison
  • Updated Javascript implementation.
  • Added Microsoft-specific stylesheet.
2.22001-07-20Jeni Tennison

Added implementation in Saxon 6.4.2.

2.32002-08-21Craig Stewart

Added Xalan-J, libxslt and 4XSLT implementation to the list.

2.42002-11-12Craig Stewart

Updated 4XSLT version to 0.12.0a3.

http://www.exslt.org/date/functions/time/date.time.html last modified 2002-11-12