CKTIS / Java
BigDecimal — aritmética decimal y redondeo
java.math.BigDecimal admite números decimales de precisión arbitraria, útiles, entre otros casos, para cálculos monetarios. Aprende a crear valores, realizar operaciones, gestionar la escala, comparar y redondear explícitamente.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
new BigDecimal("12.50"); BigDecimal.valueOf(3); a.add(b); a.subtract(b); a.multiply(b); a.divide(b, 2, RoundingMode.HALF_EVEN); a.setScale(2, RoundingMode.HALF_EVEN); a.compareTo(BigDecimal.ZERO); a.stripTrailingZeros().toPlainString();java.math.BigDecimal es un número decimal inmutable de precisión arbitraria. BigDecimal(String) construye un valor exacto a partir de texto; BigDecimal.valueOf(long) lo construye a partir de un entero. BigDecimal.valueOf(double) usa la representación textual del double, pero no puede corregir errores de cálculos anteriores. Evita new BigDecimal(0.1) si quieres representar exactamente 0.1.
BigDecimal.add, BigDecimal.subtract y BigDecimal.multiply realizan sumas, restas y multiplicaciones; conserva el resultado devuelto. BigDecimal.ZERO es cero con escala 0. BigDecimal.compareTo compara valores numéricos e ignora las diferencias de escala; equals tiene en cuenta la escala, por lo que considera distintos 2.0 y 2.00.
BigDecimal.divide sin parámetros de redondeo requiere una expansión decimal exacta y finita. La llamada BigDecimal.ONE.divide(BigDecimal.valueOf(3)) lanza una ArithmeticException porque el cociente exacto no tiene una expansión decimal finita. En cambio, la expresión 1 / 3 en Java realiza una división entera y da 0. La división entre cero también lanza esta excepción. Indica una escala y un RoundingMode cuando se admita el redondeo. HALF_EVEN elige el valor más cercano y, en caso de empate, el que tiene un dígito conservado final par.
BigDecimal.setScale establece la escala, no el número de cifras significativas; reducir la escala puede requerir redondeo. Para escalas no negativas, la escala es el número de posiciones decimales. BigDecimal.stripTrailingZeros elimina los ceros finales sin cambiar el valor y puede producir una escala negativa. BigDecimal.toPlainString representa el resultado sin exponente; no es un formato monetario adaptado a la configuración regional.
Ejemplos
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal price = new BigDecimal("12.50");
BigDecimal total = price.multiply(BigDecimal.valueOf(3))
.add(new BigDecimal("2.00"))
.subtract(new BigDecimal("1.00"))
.setScale(2, RoundingMode.HALF_EVEN);
BigDecimal share = total.divide(BigDecimal.valueOf(3), 2,
RoundingMode.HALF_EVEN);
System.out.println(total.toPlainString());
System.out.println(share.toPlainString());
System.out.println(total.compareTo(BigDecimal.ZERO) > 0);
System.out.println(new BigDecimal("12.500")
.stripTrailingZeros().toPlainString());
}
}Resultado
38.50 12.83 true 12.5
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
- java.math (Java SE 21 & JDK 21)
- BigDecimal (Java SE 21 & JDK 21)
- RoundingMode (Java SE 21 & JDK 21)
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html