Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Divisão com BigDecimal: escala e modo de arredondamento explícitos

Esta sobrecarga de `divide` permite definir a escala do quociente e escolher a regra de arredondamento. O resultado tem a escala pedida mesmo quando a divisão é exata.

Versão: Java SE 21

Sintaxe

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

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

dividend.divide(divisor, scale, roundingMode) divide dividend por divisor. Ambos os operandos são do tipo java.math.BigDecimal e não são alterados. O argumento scale, do tipo int, define a escala do resultado. O argumento do tipo java.math.RoundingMode indica como arredondar, se necessário.

Uma escala de 2 dá duas casas decimais, incluindo os zeros finais. Uma escala de 0 dá um resultado inteiro e uma escala de -2 dá um múltiplo de 100. A escala não é o número de algarismos significativos. HALF_UP escolhe o valor mais próximo à escala pedida e, em caso de empate, o mais afastado de zero.

A divisão por zero lança uma ArithmeticException. O mesmo acontece com UNNECESSARY se não for possível representar o quociente exato à escala pedida sem arredondamento. O valor exato 0.5 pode ser representado como 0.50 à escala 2 sem alterar o seu valor.

divide(divisor, roundingMode) usa a escala do dividendo. divide(divisor) exige um resultado exato e lança uma exceção se a expansão decimal não terminar. divide(divisor, mathContext) usa a precisão e o modo de arredondamento do contexto em vez de receber uma escala de destino. A sobrecarga antiga que recebe o modo de arredondamento como int está obsoleta; usa antes RoundingMode.

Exemplos

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

O quociente exato de `1 / 8` é `0.125`, pelo que `HALF_UP` dá `0.13`. O quociente de `1 / 2` não precisa de arredondamento: `toPlainString()` escreve `0.50`, mantendo o zero final exigido pela escala `2`.

Lições relacionadas

  • Java · Lição 69 · Básico · Versão: 2

Fontes