CKTIS / Java
Multiplicar números decimales con BigDecimal.multiply
Multiplica dos valores `BigDecimal` de forma exacta o redondea el producto según la precisión y el modo de redondeo de un `MathContext`.
Versión: Java SE 21
Sintaxis
public BigDecimal multiply(BigDecimal multiplicand)
public BigDecimal multiply(BigDecimal multiplicand, MathContext mc)En Java SE 21, BigDecimal.multiply es un método de instancia de java.math.BigDecimal. Para multiplicar dos objetos BigDecimal, escribe a.multiply(b), no a * b. Ambas sobrecargas devuelven el producto como BigDecimal. Los objetos son inmutables: ninguno de los operandos cambia. Guarda el valor devuelto si lo necesitas más adelante.
a.multiply(b) devuelve el producto exacto. La escala preferida es la suma de a.scale() y b.scale(). El resultado usa esa escala si la suma cabe en un int. Si la escala no es negativa, indica el número de dígitos a la derecha del separador decimal. Así, 2.50 por 1.25 da 3.1250 con escala 4, incluido el cero final. Si la suma queda fuera del intervalo del tipo int, JDK 21 puede devolver cero con la escala fijada en el límite más cercano de ese intervalo. Por ejemplo, si a vale cero con escala Integer.MAX_VALUE y b tiene escala 1, a.multiply(b) devuelve cero con escala Integer.MAX_VALUE.
a.multiply(b, mc) usa la precisión y el modo de redondeo del MathContext. Una precisión positiva limita el número de cifras significativas del resultado, no el número de decimales. Por tanto, la escala del resultado puede ser distinta de la suma de las escalas de los operandos. Con precisión 0, como en MathContext.UNLIMITED, el producto es exacto y el modo de redondeo no se aplica.
Pasar null como argumento provoca una NullPointerException. Si el resultado no puede ser exacto con la precisión solicitada, RoundingMode.UNNECESSARY provoca una ArithmeticException. Esta excepción también puede producirse si la escala necesaria para el resultado queda fuera del intervalo del tipo int.
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("2.50");
BigDecimal b = new BigDecimal("1.25");
BigDecimal exact = a.multiply(b);
BigDecimal rounded = a.multiply(b, new MathContext(3, RoundingMode.HALF_UP));
System.out.println(exact.toPlainString() + " (scale=" + exact.scale() + ")");
System.out.println(rounded.toPlainString() + " (scale=" + rounded.scale() + ")");
System.out.println(a.toPlainString());
}
}Resultado
3.1250 (scale=4) 3.13 (scale=2) 2.50
Las cadenas proporcionan los valores decimales sin convertirlos desde `double`. La primera línea muestra el producto exacto, la segunda el resultado redondeado a tres cifras significativas con `RoundingMode.HALF_UP` y la tercera el valor de `a`, que no ha cambiado.
Lecciones relacionadas
- Java · Lección 4 · Básico · Versión: 2
- Java · Lección 69 · Básico · Versión: 2