.. _months-from-duration:

====================
months-from-duration
==================== 

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

Descrição
~~~~~~~~~
A função fn:months-from-duration calcula o componente de meses de um valor 
xs:duration normalizado, como inteiro entre -11 e 11. Não é necessariamente o 
inteiro que aparece antes do M. Por exemplo, se a duração for P18M, a função 
devolve 6, e não 18, porque 12 desses meses contam como um ano, e o valor 
normalizado é P1Y6M.

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

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

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

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

   * - **XPath**
     - **Resultado**
   * - months-from-duration(xs:yearMonthDuration('P3M'))
     - 3
   * - months-from-duration(xs:yearMonthDuration('-P18M'))
     - -6
   * - months-from-duration(xs:yearMonthDuration('P1Y'))
     - 0
   * - months-from-duration(xs:yearMonthDuration('P12M'))
     - 0

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

.. toctree::
   :titlesonly:
   :glob:

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