.. _functx_total-hours-from-duration:

================================
functx:total-hours-from-duration
================================ 

The total number of hours in a dayTimeDuration

Description
~~~~~~~~~~~
The functx:total-hours-from-duration function returns the total number of hours 
in $duration. If it is an uneven number of hours, it will return a fractional 
part. This function is different from the built-in fn:hours-from-duration 
function because the latter will normalize the value and only give you the 
remainder number of hours between 1 and 24. For example, 
fn:hours-from-duration(xs:dayTimeDuration("PT26H30M")) will return 2, while 
functx:total-hours-from-duration(xs:dayTimeDuration("PT26H30M")) will return 
26.5. If $duration is the empty sequence, the empty sequence is returned.

.. list-table::
   :widths: 40 60
   :header-rows: 1

   * - **Parameters**
     - **Description**
   * - duration:time()
     - the duration

Examples
~~~~~~~~
.. list-table::
   :widths: 50 50
   :header-rows: 1

   * - **XPath**
     - **Results**
   * - functx:total-hours-from-duration(xs:dayTimeDuration('PT26H'))
     - 26
   * - functx:total-hours-from-duration(xs:dayTimeDuration('PT1H30M'))
     - 1.5
   * - functx:total-hours-from-duration(xs:dayTimeDuration('-PT3H'))
     - -3
   * - functx:total-hours-from-duration(xs:dayTimeDuration('P1D'))
     - 24
   * - functx:total-hours-from-duration(xs:dayTimeDuration('P1DT2H'))
     - 26

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`hours-from-duration`.
* :ref:`functx_total-seconds-from-duration`.
* :ref:`functx_total-minutes-from-duration`.
* :ref:`functx_total-days-from-duration`.
* :ref:`functx_total-months-from-duration`.
* :ref:`functx_total-years-from-duration`.