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

CKTIS / Java

BigDecimal.subtract — restar valores decimales

Resta dos valores `BigDecimal` de forma exacta o redondea la diferencia según un `MathContext`. Ninguno de los operandos cambia.

Versión: Java SE 21

Sintaxis

public BigDecimal subtract(BigDecimal subtrahend)
public BigDecimal subtract(BigDecimal subtrahend, MathContext mc)

BigDecimal.subtract es un método de instancia de java.math.BigDecimal. La llamada a.subtract(b) calcula a − b: resta el argumento del objeto sobre el que se invoca el método. El orden importa. El operador - no se puede usar con objetos BigDecimal.

subtract(BigDecimal) devuelve la diferencia exacta, sin redondear, con una escala igual a Math.max(a.scale(), b.scale()). Una escala no negativa indica el número de cifras después del separador decimal, incluidos los ceros finales. BigDecimal es inmutable, por lo que ninguno de los operandos cambia. Guarda el valor devuelto si necesitas la diferencia más adelante.

subtract(BigDecimal, MathContext) redondea la diferencia exacta si es necesario, según la precisión y el modo de redondeo del contexto. La precisión cuenta cifras significativas, no posiciones decimales. Una precisión de 0, como en MathContext.UNLIMITED, indica un cálculo exacto sin redondeo. Si hace falta redondear y el modo es RoundingMode.UNNECESSARY, el método lanza ArithmeticException. Pasar null como valor que se resta o como contexto provoca NullPointerException.

Ejemplos

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

public class Main {
    public static void main(String[] args) {
        BigDecimal a = new BigDecimal("12.30");
        BigDecimal b = new BigDecimal("0.456");

        BigDecimal exact = a.subtract(b);
        BigDecimal rounded = a.subtract(b, new MathContext(3, RoundingMode.HALF_UP));

        System.out.println(exact.toPlainString());
        System.out.println(exact.scale());
        System.out.println(rounded.toPlainString());
        System.out.println(a.toPlainString());
        System.out.println(b.toPlainString());
    }
}

Resultado

11.844
3
11.8
12.30
0.456

Los constructores que reciben cadenas conservan los valores decimales exactos sin pasar por `double`. El programa muestra la diferencia exacta `11.844`, su escala `3`, el resultado `11.8` redondeado a tres cifras significativas con `HALF_UP` y, por último, los operandos sin cambios `12.30` y `0.456`.

Lecciones relacionadas

  • Java · Lección 69 · Básico · Versión: 2

Fuentes