WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Decimal.quantize — einen Dezimalexponenten festlegen

decimal.Decimal.quantize verwendet den Exponenten von exp als Zielexponenten und rundet den Wert bei Bedarf. Damit lässt sich die gewünschte Anzahl der Dezimalstellen festlegen und eine Rundungsregel ausdrücklich auswählen. Bei clamp=1 kann der gespeicherte Exponent eines endlichen Ergebnisses kleiner als der Zielexponent sein.

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

Syntax

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

decimal.Decimal.quantize gibt einen neuen Decimal-Wert zurück. Der Exponent von exp legt die gewünschte Skalierung fest: Decimal('0.01') steht für eine Rundung auf zwei Dezimalstellen, nicht auf Vielfache des Werts von exp. Bei clamp=1 im Kontext kann die Operation den gespeicherten Exponenten eines endlichen Ergebnisses verringern und Nullen an den Koeffizienten anhängen, ohne den Zahlenwert des Ergebnisses zu ändern.

Das Argument rounding hat Vorrang vor der Regel in context; werden beide weggelassen, gilt der aktuelle Kontext. Erzeuge Werte aus Zeichenfolgen, damit keine Näherungen von float übernommen werden.

Wird die Kontextpräzision für den Koeffizienten des Ergebnisses überschritten, wird InvalidOperation signalisiert: Bei aktivierter Falle wird eine Ausnahme ausgelöst, andernfalls ist das Ergebnis NaN. Auch die Exponentengrenzen des Kontexts gelten. Die Operation signalisiert niemals Underflow.

Das Beispiel vergleicht ROUND_HALF_EVEN mit ROUND_HALF_UP und zeigt, wie nachgestellte Nullen ergänzt werden.

Beispiele

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

Ergebnis

2.66
2.67
2.00

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen