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

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