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