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.