.. _hours-from-duration:

===================
hours-from-duration
=================== 

As horas de uma duração

Descrição
~~~~~~~~~
A função fn:hours-from-duration calcula o componente de horas de um valor 
xs:duration normalizado, como inteiro entre -23 e 23. Não é necessariamente o 
inteiro que aparece antes do H. Por exemplo, se a duração for PT1H90M, a função 
devolve 2, e não 1, porque 90 minutos são 1,5 hora, e o valor normalizado é 
PT2H30M. Do mesmo jeito, se a duração for PT36H, o resultado é 12, porque o 
valor normalizado é P1DT12H.

Já a função functx:total-hours-from-duration devolveria 2.5 no primeiro caso e 
36 no segundo.

Para o total de horas como número decimal, veja 
functx:total-hours-from-duration.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:numeric()
     - a duração de onde ler as horas

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

   * - **XPath**
     - **Resultado**
   * - hours-from-duration(xs:dayTimeDuration('P1DT5H'))
     - 5
   * - hours-from-duration(xs:dayTimeDuration('-PT36H'))
     - -12
   * - hours-from-duration(xs:dayTimeDuration('PT1H90M'))
     - 2
   * - hours-from-duration(xs:dayTimeDuration('PT2H59M'))
     - 2
   * - hours-from-duration(xs:dayTimeDuration('PT3600S'))
     - 1

Veja também
~~~~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_total-hours-from-duration`.