.. _years-from-duration:

===================
years-from-duration
=================== 

O número de anos de uma duração

Descrição
~~~~~~~~~
A função fn:years-from-duration calcula o componente de anos de um valor 
xs:duration normalizado. Não é necessariamente o inteiro que aparece antes do Y. 
Por exemplo, se a duração for P1Y18M, a função devolve 2, e não 1, porque 18 
meses são 1,5 ano, e o valor normalizado é P2Y6M.

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

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

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

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

   * - **XPath**
     - **Resultado**
   * - years-from-duration(xs:yearMonthDuration('P3Y'))
     - 3
   * - years-from-duration(xs:yearMonthDuration('P3Y11M'))
     - 3
   * - years-from-duration(xs:yearMonthDuration('-P18M'))
     - -1
   * - years-from-duration(xs:yearMonthDuration('P1Y18M'))
     - 2
   * - years-from-duration(xs:yearMonthDuration('P12M'))
     - 1

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

.. toctree::
   :titlesonly:
   :glob:

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