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

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.

Start your free trial