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

CKTIS / Python

decimal — aritmética decimal

O módulo decimal disponibiliza Decimal para cálculos decimais com controlo explícito da precisão e do arredondamento, útil, entre outros casos, para valores monetários.

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

Sintaxe

import decimal

decimal.Decimal('1.25')
with decimal.localcontext(prec=28):
    decimal.Decimal('1.255').quantize(decimal.Decimal('0.01'), rounding=decimal.ROUND_HALF_EVEN)

decimal é um módulo da biblioteca padrão que disponibiliza o tipo Decimal. Ao contrário de float binário, pode representar exatamente frações decimais finitas e preservar zeros finais.

Crie valores a partir de texto, por exemplo com decimal.Decimal('0.1'). A criação a partir de um float preserva o seu valor binário exato, que pode não corresponder ao valor decimal pretendido.

A precisão do contexto determina o número de algarismos significativos dos resultados, não o número de casas decimais; não trunca os algarismos do construtor de cadeias de caracteres. A divisão pode exigir arredondamento. localcontext() altera temporariamente as definições e repõe depois as anteriores.

quantize(decimal.Decimal('0.01')) define um expoente correspondente a duas casas decimais. ROUND_HALF_EVEN resolve os empates a favor de um algarismo final par. Se a precisão for insuficiente, quantize() assinala InvalidOperation.

Exemplos

import decimal

with decimal.localcontext(prec=28):
    total = decimal.Decimal('0.10') * 3
    rounded = decimal.Decimal('2.675').quantize(
        decimal.Decimal('0.01'), rounding=decimal.ROUND_HALF_EVEN
    )
    print(total)
    print(rounded)

Resultado

0.30
2.68

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