Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Decimal.quantize — impostare un esponente decimale

decimal.Decimal.quantize usa l’esponente di exp come obiettivo e arrotonda il valore se necessario. Consente di indicare il numero di cifre decimali desiderato e di scegliere esplicitamente una regola di arrotondamento. Con clamp=1, l’esponente memorizzato di un risultato finito può essere inferiore a quello desiderato.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

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

decimal.Decimal.quantize restituisce un nuovo Decimal. L’esponente di exp determina la scala desiderata: Decimal('0.01') indica un arrotondamento a due cifre decimali, non a multipli del valore di exp. Se nel contesto è impostato clamp=1, l’operazione può ridurre l’esponente memorizzato di un risultato finito e aggiungere zeri in coda al coefficiente senza cambiarne il valore numerico.

L’argomento rounding prevale sulla regola in context; se entrambi sono omessi, viene usato il contesto corrente. Crea i valori a partire da stringhe per evitare di introdurre approssimazioni di float.

Il superamento della precisione del contesto per il coefficiente del risultato segnala InvalidOperation: una trappola attiva solleva un’eccezione; altrimenti il risultato è NaN. Si applicano anche i limiti di esponente del contesto. L’operazione non segnala mai Underflow.

L’esempio confronta ROUND_HALF_EVEN con ROUND_HALF_UP e mostra l’aggiunta di zeri finali.

Esempi

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))

Risultato

2.66
2.67
2.00

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti