.. _round-half-to-even:

==================
round-half-to-even
================== 

Arredonda um valor numérico, levando as metades para o número par mais próximo

Descrição
~~~~~~~~~
A função fn:round-half-to-even arredonda um valor numérico levando as metades 
para o número par mais próximo. Esse tipo de arredondamento é usado em 
aplicações financeiras, para que a soma de uma coluna de números arredondados 
fique mais perto da soma dos mesmos números sem arredondar.

O valor devolvido é arredondado para o número de casas decimais indicado em 
$precision. Por exemplo, com precisão 2, a função arredonda 594.3271 para 
594.33. Com precisão 0, o número é arredondado para um inteiro. Uma precisão 
negativa arredonda à esquerda do ponto decimal: com $precision igual a -2, a 
função arredonda 594.3271 para 600. Se $precision for omitido, vale 0.

Se o argumento estiver exatamente no meio entre dois valores, é arredondado para 
o vizinho par.

O tipo do resultado depende do tipo numérico do argumento. Se $arg não tiver 
tipo, é convertido em xs:double.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:numeric()
     - o número a arredondar
   * - precision:integer()
     - a precisão do arredondamento

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

   * - **XPath**
     - **Resultado**
   * - round-half-to-even(5.5)
     - 6
   * - round-half-to-even(6.5)
     - 6
   * - round-half-to-even(9372.253, 2)
     - 9372.25
   * - round-half-to-even(9372.253, 0)
     - 9372
   * - round-half-to-even(9372.253, -3)
     - 9000

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`round`.
* :ref:`ceiling`.
* :ref:`floor`.