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

CKTIS / Java

BigDecimal: cálculo decimal exacto, escala y comparación

Lee valores decimales sin pasar por `double`, calcula con exactitud, elige la escala y la regla de redondeo y compara números sin tener en cuenta su escala.

Versión: Java SE 21

Sintaxis

java.math.BigDecimal — Java SE 21

BigDecimal(String val)
BigDecimal add(BigDecimal augend)
BigDecimal multiply(BigDecimal multiplicand)
BigDecimal setScale(int newScale)
BigDecimal setScale(int newScale, RoundingMode roundingMode)
BigDecimal stripTrailingZeros()
int compareTo(BigDecimal val)
String toPlainString()

RoundingMode: java.math.RoundingMode

En Java SE 21, el constructor BigDecimal(String) del paquete java.math lee un valor decimal exacto sin pasar por double. Usa un punto decimal, no una coma; no se admiten espacios en blanco ni separadores de grupos de dígitos. Un texto no válido lanza NumberFormatException. Sin exponente, la escala cuenta los dígitos después del punto, incluidos los ceros finales; si hay un exponente explícito, se resta de esa escala.

Los métodos de un argumento BigDecimal.add y BigDecimal.multiply devuelven la suma y el producto exactos. La suma toma la mayor escala de los operandos; la escala preferida del producto es la suma de ambas escalas. En JDK 21, si esa suma queda fuera del rango de int, la multiplicación puede lanzar ArithmeticException. Si el objeto sobre el que se invoca el método (this) vale cero, el método devuelve cero con la escala ajustada al límite más cercano de ese rango. Las sobrecargas con MathContext pueden redondear según ese contexto. Los objetos BigDecimal son inmutables: conserva el resultado devuelto, ya que los operandos no cambian.

BigDecimal.setScale fija la escala del resultado. setScale(int) lanza ArithmeticException si hace falta redondear; setScale(int, RoundingMode) permite elegir una regla. HALF_UP redondea al valor más cercano y, en caso de empate, se aleja de cero. UNNECESSARY lanza ArithmeticException si hace falta redondear. La sobrecarga setScale(int, int) está obsoleta.

BigDecimal.stripTrailingZeros elimina los ceros finales de la representación sin cambiar el valor. La escala puede volverse negativa, como ocurre al recortar 600.0 (escala -2); para cero devuelve BigDecimal.ZERO. Un desbordamiento de la escala lanza ArithmeticException. BigDecimal.toPlainString devuelve texto sin exponente ni formato regional. Para obtener un número fijo de decimales, fija primero la escala. Al volver a leer el texto se conserva el valor, pero no necesariamente la escala.

BigDecimal.compareTo compara números sin tener en cuenta la escala: devuelve -1, 0 o 1 según si el primer operando es menor, igual o mayor que el segundo. Usa a.compareTo(b) == 0 para comprobar la igualdad numérica; equals exige el mismo valor y la misma escala, así que devuelve false para 2.0 y 2.00.

Ejemplos

import java.math.BigDecimal;
import java.math.RoundingMode;

public class Main {
    public static void main(String[] args) {
        BigDecimal unitPrice = new BigDecimal("2.500");
        BigDecimal quantity = new BigDecimal("3");
        BigDecimal fee = new BigDecimal("0.005");
        BigDecimal exact = unitPrice.multiply(quantity).add(fee);
        BigDecimal rounded = exact.setScale(2, RoundingMode.HALF_UP);

        BigDecimal stripped = new BigDecimal("600.0").stripTrailingZeros();
        BigDecimal sameValue = new BigDecimal("600.00");

        System.out.println("exact: " + exact.toPlainString());
        System.out.println("rounded: " + rounded.toPlainString());
        System.out.println("stripped scale: " + stripped.scale());
        System.out.println("plain: " + stripped.toPlainString());
        System.out.println("compareTo: " + stripped.compareTo(sameValue));
        System.out.println("equals: " + stripped.equals(sameValue));
    }
}

Resultado

exact: 7.505
rounded: 7.51
stripped scale: -2
plain: 600
compareTo: 0
equals: false

El resultado exacto `7.505` se redondea a `7.51`. Al eliminar los ceros de `600.0` se obtiene la escala `-2`, pero el texto sin exponente es `600`. Al compararlo con `600.00` se obtiene `0`, mientras que `equals` devuelve `false`.

Lecciones relacionadas

  • Java · Lección 60 · Intermedio · Versión: 2

Fuentes