Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

decimal.ROUND_HALF_UP — os empates afastam-se de zero

decimal.ROUND_HALF_UP escolhe o resultado mais próximo e, nos empates exatos, arredonda afastando-se de zero, incluindo para valores negativos.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

value.quantize(Decimal('0.01'), rounding=decimal.ROUND_HALF_UP)

decimal.ROUND_HALF_UP é uma constante de modo de arredondamento, não uma função. Escolhe o valor mais próximo; exatamente a meio, escolhe o valor mais afastado de zero. Isto não significa que arredonde sempre em direção ao infinito positivo.

Passe-a a quantize() através do argumento rounding. O modelo Decimal('0.01') especifica duas casas decimais. Crie os valores a partir de cadeias de caracteres: a conversão de float preserva a sua aproximação binária.

Ao contrário de ROUND_UP, este modo não arredonda sempre afastando-se de zero. ROUND_HALF_EVEN resolve os empates escolhendo um último algarismo retido par. A precisão do contexto continua a limitar o resultado.

Exemplos

import decimal

context = decimal.Context(prec=10)
for text in ('1.234', '1.235', '-1.235'):
    value = decimal.Decimal(text)
    result = value.quantize(
        decimal.Decimal('0.01'),
        rounding=decimal.ROUND_HALF_UP,
        context=context,
    )
    print(f'{text} -> {result}')

Resultado

1.234 -> 1.23
1.235 -> 1.24
-1.235 -> -1.24

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes