Name

[2.0] timezone-from-date()

Given an xs:date value, returns its timezone component.

Syntax

xs:dayTimeDuration? timezone-from-date(xs:date?)

Input

An xs:date value.

Output

An xs:dayTimeDuration that represents the timezone component of the given xs:date value. If the argument is the empty sequence, this function returns the empty sequence.

Defined in

XQuery 1.0 and XPath 2.0 Functions and Operators section 10.5, “Component Extraction Functions on Durations, Dates and Times.”

Example

This stylesheet illustrates the timezone-from-date() function:

<?xml version="1.0"?>
<!-- timezone-from-date.xsl -->
<xsl:stylesheet version="2.0"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xsl:output method="text"/>

  <xsl:template match="/">
    <xsl:text>&#xA;Extracting the timezone from an xs:date:</xsl:text>
    <xsl:variable name="currentDate" as="xs:date" select="current-date()"/>
    <xsl:text>&#xA;&#xA;  The current date is: </xsl:text>
    <xsl:value-of select="$currentDate"/>

    <xsl:text>&#xA;&#xA;  The current timezone is: </xsl:text>
    <xsl:value-of select="timezone-from-date($currentDate)"/>
    <xsl:text>&#xA;    The timezone is also known as </xsl:text>
    <xsl:value-of select="format-date($currentDate, '[ZN]')"/>
  </xsl:template>

</xsl:stylesheet>

The stylesheet creates these results:

Extracting the timezone from an xs:date:

  The current date is: 2006-11-16-05:00

  The current timezone is: -PT5H
    The timezone is also known as EST

Notice that the first result was generated by the

Get XSLT, 2nd Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.