Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

Decimal.quantize — nastavení desetinného exponentu

decimal.Decimal.quantize používá exponent argumentu exp jako cílový exponent a v případě potřeby hodnotu zaokrouhlí. Umožňuje určit požadovaný počet desetinných míst a výslovně zvolit pravidlo zaokrouhlování. Při clamp=1 může být uložený exponent konečného výsledku nižší než cílový.

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

Syntaxe

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

decimal.Decimal.quantize vrací nový objekt Decimal. Exponent exp určuje cílové měřítko: Decimal('0.01') znamená zaokrouhlení na dvě desetinná místa, nikoli na násobky hodnoty exp. Pokud je v kontextu nastaveno clamp=1, může operace snížit uložený exponent konečného výsledku a přidat na konec jeho koeficientu nuly, aniž se změní číselná hodnota výsledku.

Argument rounding má přednost před pravidlem v context; pokud vynecháte oba, použije se aktuální kontext. Hodnoty vytvářejte z řetězců, abyste nepřevzali aproximace typu float.

Překročení přesnosti kontextu pro koeficient výsledku signalizuje InvalidOperation: aktivní past vyvolá výjimku, jinak je výsledkem NaN. Platí také meze exponentu kontextu. Operace nikdy nesignalizuje Underflow.

Příklad porovnává ROUND_HALF_EVEN a ROUND_HALF_UP a ukazuje přidávání koncových nul.

Příklady

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

Výsledek

2.66
2.67
2.00

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje