EXSLT - date:time - Version 1

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

Function Syntax

string date:time(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 the format defined as the lexical representation of xs:dateTime in [3.2.7 dateTime] 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.

Implementations

No XSLT processors that we know of have built-in support for date:time.

There are currently no third-party implementations of date:time.

Change History

Submitted: 2001-05-12
Creator: Jeni Tennison (http://www.jenitennison.com/)

Returns the time part of a date/time string, or the current time.

http://www.exslt.org/date/functions/time/date.time.1.html last modified 2001-05-12