EXSLT - date:year - Implementer Page

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

Function Syntax

number date:year(string?)

Template Syntax

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

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.

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

Implementations

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

Processor	Processor Version	Implemented Version
SAXON from Michael Kay	6.4.2	2
Xalan-J from Apache	2.4.D1	2
4XSLT, from 4Suite.	0.12.0a3	2
libxslt from Daniel Veillard et al.	1.0.19	2

The following implementations of date:year are available:

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

Change History

Previous Version: date.year.1.html

Version	Modified	By	Details
2	2001-06-11	Jeni Tennison	Removed second (optional date format) argument. Added implementations in Javascript, XSLT and EXSLT - Functions.
2.1	2001-06-16	Jeni Tennison	Updated Javascript implementation. Added Microsoft-specific stylesheet.
2.2	2001-07-20	Jeni Tennison	Added implementation in Saxon 6.4.2.
2.3	2002-08-21	Craig Stewart	Added Xalan-J, and libxslt and 4XSLT implementation to the list.
2.4	2002-11-12	Craig Stewart	Updated 4XSLT version to 0.12.0a3.