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

CKTIS / Java

División con BigDecimal: escala y modo de redondeo explícitos

Esta sobrecarga de `divide` permite fijar la escala del cociente y elegir la regla de redondeo. El resultado tiene la escala solicitada incluso cuando la división es exacta.

Versión: Java SE 21

Sintaxis

public BigDecimal divide(BigDecimal divisor, int scale, RoundingMode roundingMode)

BigDecimal quotient = dividend.divide(divisor, scale, roundingMode);

dividend.divide(divisor, scale, roundingMode) divide dividend entre divisor. Ambos operandos son de tipo java.math.BigDecimal y no se modifican. El argumento scale, de tipo int, fija la escala del resultado. El argumento de tipo java.math.RoundingMode indica cómo redondear si hace falta.

Una escala de 2 da dos cifras después del separador decimal, incluidos los ceros finales. Una escala de 0 da un resultado entero y una escala de -2 da un múltiplo de 100. La escala no es el número de cifras significativas. HALF_UP elige el valor más cercano a la escala solicitada y, en caso de empate, el más alejado de cero.

Dividir entre cero lanza una ArithmeticException. Con UNNECESSARY se lanza la misma excepción si el cociente exacto no se puede representar con la escala solicitada sin redondear. El valor exacto 0.5 se puede representar como 0.50 con escala 2 sin cambiar su valor.

divide(divisor, roundingMode) usa la escala del dividendo. divide(divisor) exige un resultado exacto y lanza una excepción si la expansión decimal no termina. divide(divisor, mathContext) usa la precisión y el modo de redondeo del contexto en vez de recibir una escala objetivo. La sobrecarga antigua que recibe el modo de redondeo como int está obsoleta; usa RoundingMode.

Ejemplos

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

public class Main {
    public static void main(String[] args) {
        BigDecimal one = BigDecimal.ONE;
        BigDecimal rounded = one.divide(BigDecimal.valueOf(8), 2, RoundingMode.HALF_UP);
        BigDecimal exact = one.divide(BigDecimal.valueOf(2), 2, RoundingMode.HALF_UP);

        System.out.println(rounded.toPlainString());
        System.out.println(exact.toPlainString());
    }
}

Resultado

0.13
0.50

El cociente exacto de `1 / 8` es `0.125`, así que `HALF_UP` da `0.13`. El cociente de `1 / 2` no necesita redondeo: `toPlainString()` imprime `0.50` y conserva el cero final que exige la escala `2`.

Lecciones relacionadas

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

Fuentes