Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

Decimal.quantize — définir un exposant décimal

decimal.Decimal.quantize prend l’exposant de exp comme cible et arrondit la valeur si nécessaire. Cette méthode permet de définir le nombre de décimales visé et de choisir explicitement une règle d’arrondi. Avec clamp=1, l’exposant stocké d’un résultat fini peut être inférieur à l’exposant cible.

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

Syntaxe

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

decimal.Decimal.quantize renvoie un nouveau Decimal. L’exposant de exp définit l’échelle cible : Decimal('0.01') indique un arrondi à deux décimales, et non à des multiples de la valeur de exp. Si clamp=1 dans le contexte, l’opération peut abaisser l’exposant stocké d’un résultat fini et ajouter des zéros à la fin de son coefficient sans changer sa valeur numérique.

L’argument rounding prend le pas sur la règle de context ; si les deux sont omis, le contexte courant est utilisé. Construisez les valeurs à partir de chaînes pour éviter d’introduire des approximations de float.

Si la précision du contexte est dépassée pour le coefficient du résultat, InvalidOperation est signalé : un piège activé lève une exception ; sinon, le résultat est NaN. Les limites d’exposant du contexte s’appliquent également. L’opération ne signale jamais Underflow.

L’exemple compare ROUND_HALF_EVEN à ROUND_HALF_UP et montre l’ajout de zéros finaux.

Exemples

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

Résultat

2.66
2.67
2.00

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources