XSLT, 2nd Edition

Name

[2.0] hours-from-dateTime()

Given an xs:dateTime value, returns its hours value.

Syntax

xs:integer? hours-from-dateTime(xs:dateTime?)

Inputs

An xs:dateTime value.

Output

An xs:integer representing the hours component of the given xs:dateTime value. If the input 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 demonstrates the hours-from-dateTime() function:

<?xml version="1.0"?>
<!-- hours-from-datetime.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 hour from an xs:dateTime:</xsl:text>
    <xsl:variable name="currentDateTime" as="xs:dateTime" 
      select="current-dateTime()"/>
    <xsl:text>&#xA;&#xA;  The current date and time is: </xsl:text>
    <xsl:value-of select="$currentDateTime"/>

    <xsl:text>&#xA;&#xA;  The current hour is: </xsl:text>
    <xsl:value-of select="hours-from-dateTime($currentDateTime)"/>
    <xsl:text>&#xA;    Also known as </xsl:text>
    <xsl:value-of select="format-dateTime($currentDateTime, '[h] [Pn]')"/>
    <xsl:text>&#xA;    or </xsl:text>
    <xsl:value-of select="format-dateTime($currentDateTime, '[H] [ZN]')"/>
    <xsl:text>&#xA;    or </xsl:text>
    <xsl:value-of select="format-dateTime($currentDateTime, '[H] [z]')"/>
  </xsl:template>

</xsl:stylesheet>

The stylesheet ...