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

CKTIS / Python

Decimal.quantize — definir um expoente decimal

decimal.Decimal.quantize usa o expoente de exp como alvo e arredonda o valor se necessário. Permite definir o número pretendido de casas decimais e escolher explicitamente uma regra de arredondamento. Com clamp=1, o expoente armazenado de um resultado finito pode ser inferior ao expoente pretendido.

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

Sintaxe

Decimal.quantize(exp, rounding=None, context=None)

decimal.Decimal.quantize devolve um novo Decimal. O expoente de exp define a escala pretendida: Decimal('0.01') indica um arredondamento a duas casas decimais, não a múltiplos do valor de exp. Com clamp=1 no contexto, a operação pode reduzir o expoente armazenado de um resultado finito e acrescentar zeros ao fim do seu coeficiente sem alterar o valor numérico do resultado.

O argumento rounding prevalece sobre a regra em context; se ambos forem omitidos, é usado o contexto atual. Crie os valores a partir de cadeias de caracteres para evitar incorporar aproximações de float.

Se a precisão do contexto para o coeficiente do resultado for excedida, é sinalizado InvalidOperation: uma armadilha ativa gera uma exceção; caso contrário, o resultado é NaN. Aplicam-se também os limites de expoente do contexto. A operação nunca sinaliza Underflow.

O exemplo compara ROUND_HALF_EVEN com ROUND_HALF_UP e demonstra a adição de zeros finais.

Exemplos

from decimal import Context, Decimal, ROUND_HALF_EVEN, ROUND_HALF_UP

ctx = Context(prec=10)
value = Decimal('2.665')
places = Decimal('0.01')

print(value.quantize(places, rounding=ROUND_HALF_EVEN, context=ctx))
print(value.quantize(places, rounding=ROUND_HALF_UP, context=ctx))
print(Decimal('2').quantize(places, context=ctx))

Resultado

2.66
2.67
2.00

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