Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

Decimal.quantize — fijar un exponente decimal

decimal.Decimal.quantize usa el exponente de exp como objetivo y redondea el valor si es necesario. Permite indicar el número de decimales deseado y seleccionar explícitamente una regla de redondeo. Con clamp=1, el exponente almacenado de un resultado finito puede ser menor que el objetivo.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

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

decimal.Decimal.quantize devuelve un nuevo Decimal. El exponente de exp establece la escala objetivo: Decimal('0.01') indica un redondeo a dos decimales, no a múltiplos del valor de exp. Si el contexto tiene clamp=1, la operación puede reducir el exponente almacenado de un resultado finito y añadir ceros al final de su coeficiente sin cambiar su valor numérico.

El argumento rounding tiene prioridad sobre la regla de context; si se omiten ambos, se usa el contexto actual. Construye los valores a partir de cadenas para evitar incorporar aproximaciones de float.

Si se supera la precisión del contexto para el coeficiente del resultado, se señala InvalidOperation: una trampa activada genera una excepción; de lo contrario, el resultado es NaN. También se aplican los límites de exponente del contexto. La operación nunca señala Underflow.

El ejemplo compara ROUND_HALF_EVEN con ROUND_HALF_UP y muestra cómo se añaden ceros finales.

Ejemplos

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

Resultado

2.66
2.67
2.00

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes