EXSLT - date:year - Version 1

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

Function Syntax

number date:year(string?, string?)

The date:year function returns the year of a date as a number. 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 the first argument must be a right-truncated string in the format defined as the lexical representation of xs:dateTime 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:gYearMonth (CCYY-MM)
xs:gYear (CCYY)

If the date/time string is not in one of these formats, then NaN is returned.

The second argument is a the name of a date format (declared by date:date-format) that is used to work out the numerical year of the date. For details about how the format pattern is constructed and used, see date:date-format).

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:year.

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

Change History

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

Returns the year given in a date/time string as a number.