CKTIS / Java
BigDecimal.add — suma exacta o con redondeo
Suma valores BigDecimal sin redondear o usa MathContext para fijar la precisión y el modo de redondeo del resultado.
Versión: Java SE 21
Sintaxis
import java.math.BigDecimal;
import java.math.MathContext;
BigDecimal exact = a.add(b);
BigDecimal rounded = a.add(b, mc);
// Instance method signatures in java.math.BigDecimal:
// public BigDecimal add(BigDecimal augend)
// public BigDecimal add(BigDecimal augend, MathContext mc)BigDecimal.add es un método de instancia de java.math.BigDecimal. En a.add(b), el objeto a y el argumento b son los dos sumandos. No se pueden sumar dos objetos BigDecimal con +. Estos objetos son inmutables: el método devuelve el resultado sin modificar ninguno de los sumandos. Guarda o usa el valor devuelto; a.add(b); por sí solo no actualiza a.
a.add(b) devuelve la suma exacta con escala max(a.scale(), b.scale()). Una escala no negativa indica cuántas posiciones hay después del separador decimal, incluidos los ceros finales. También puede ser negativa: con escala -2, el valor es el entero almacenado multiplicado por 100.
a.add(b, mc) recibe un MathContext de java.math. Una precisión positiva limita el número de cifras significativas del resultado, no el número de decimales. El método redondea la suma exacta si hace falta según el modo del contexto, por lo que la escala puede cambiar. Con precisión positiva, si solo uno de los sumandos es cero, el resultado tiene el valor numérico del sumando distinto de cero, redondeado si hace falta. La escala del resultado puede diferir de la de ese sumando incluso si no hace falta redondear. Por ejemplo, sumar 0.00 a 1 con una precisión de 3 da 1.00. La precisión 0, como en MathContext.UNLIMITED, indica que la suma no se redondea.
Si el redondeo cambiara el valor, RoundingMode.UNNECESSARY provoca una ArithmeticException. Pasar null como b o mc provoca una 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.40");
BigDecimal b = new BigDecimal("0.350");
MathContext mc = new MathContext(3, RoundingMode.HALF_UP);
BigDecimal exact = a.add(b);
BigDecimal rounded = a.add(b, mc);
System.out.println(exact.toPlainString());
System.out.println(rounded.toPlainString());
System.out.println(a.toPlainString());
}
}Resultado
12.750 12.8 12.40
Los sumandos se construyen a partir de cadenas para evitar una conversión previa a `double`. La suma exacta `12.750` tiene escala 3; con tres cifras significativas, `HALF_UP` da `12.8`. La última línea muestra que `a` sigue siendo `12.40`.
Lecciones relacionadas
- Java · Lección 4 · Básico · Versión: 2
- Java · Lección 69 · Básico · Versión: 2