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

CKTIS / Java

BigDecimal: cálculo decimal exato, escala e comparação

Lê valores decimais sem passar por `double`, calcula com exatidão, escolhe a escala e a regra de arredondamento e compara números sem considerar a escala.

Versão: Java SE 21

Sintaxe

java.math.BigDecimal — Java SE 21

BigDecimal(String val)
BigDecimal add(BigDecimal augend)
BigDecimal multiply(BigDecimal multiplicand)
BigDecimal setScale(int newScale)
BigDecimal setScale(int newScale, RoundingMode roundingMode)
BigDecimal stripTrailingZeros()
int compareTo(BigDecimal val)
String toPlainString()

RoundingMode: java.math.RoundingMode

No Java SE 21, o construtor BigDecimal(String) do pacote java.math lê um valor decimal exato sem passar por double. Usa um ponto decimal, não uma vírgula; não são aceites espaços em branco nem separadores de grupos de algarismos. Um texto inválido provoca NumberFormatException. Sem expoente, a escala conta os algarismos depois do ponto, incluindo os zeros finais; se houver um expoente explícito, este é subtraído à escala.

Os métodos de um argumento BigDecimal.add e BigDecimal.multiply devolvem a soma e o produto exatos. A soma fica com a maior escala dos operandos; a escala preferida do produto é a soma das escalas. No JDK 21, se essa soma ficar fora do intervalo de int, a multiplicação pode lançar ArithmeticException. Se o objeto em que o método é chamado (this) tiver valor zero, o método devolve zero com a escala ajustada ao limite mais próximo desse intervalo. As sobrecargas com MathContext podem arredondar de acordo com esse contexto. Os objetos BigDecimal são imutáveis: guarda o resultado devolvido, pois os operandos não mudam.

BigDecimal.setScale define a escala do resultado. setScale(int) lança ArithmeticException se for necessário arredondar; setScale(int, RoundingMode) permite escolher a regra. HALF_UP arredonda para o valor mais próximo e, em caso de empate, para longe de zero. UNNECESSARY lança ArithmeticException se for necessário arredondar. A sobrecarga setScale(int, int) está obsoleta.

BigDecimal.stripTrailingZeros remove os zeros finais da representação sem alterar o valor. A escala pode tornar-se negativa, como acontece com 600.0 após a remoção (escala -2); para zero devolve BigDecimal.ZERO. Se a escala ultrapassar o intervalo permitido, é lançada ArithmeticException. BigDecimal.toPlainString devolve texto sem expoente nem formatação regional. Para obter um número fixo de casas decimais, define primeiro a escala. Ao reler o texto, mantém-se o valor, mas não necessariamente a escala.

BigDecimal.compareTo compara valores numéricos independentemente da escala: devolve -1, 0 ou 1 quando o primeiro operando é, respetivamente, menor, igual ou maior do que o segundo. Usa a.compareTo(b) == 0 para testar a igualdade numérica; equals exige o mesmo valor e a mesma escala, pelo que devolve false para 2.0 e 2.00.

Exemplos

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

public class Main {
    public static void main(String[] args) {
        BigDecimal unitPrice = new BigDecimal("2.500");
        BigDecimal quantity = new BigDecimal("3");
        BigDecimal fee = new BigDecimal("0.005");
        BigDecimal exact = unitPrice.multiply(quantity).add(fee);
        BigDecimal rounded = exact.setScale(2, RoundingMode.HALF_UP);

        BigDecimal stripped = new BigDecimal("600.0").stripTrailingZeros();
        BigDecimal sameValue = new BigDecimal("600.00");

        System.out.println("exact: " + exact.toPlainString());
        System.out.println("rounded: " + rounded.toPlainString());
        System.out.println("stripped scale: " + stripped.scale());
        System.out.println("plain: " + stripped.toPlainString());
        System.out.println("compareTo: " + stripped.compareTo(sameValue));
        System.out.println("equals: " + stripped.equals(sameValue));
    }
}

Resultado

exact: 7.505
rounded: 7.51
stripped scale: -2
plain: 600
compareTo: 0
equals: false

O resultado exato `7.505` é arredondado para `7.51`. Ao remover os zeros de `600.0`, a escala passa a `-2`, mas o texto sem expoente é `600`. A comparação com `600.00` dá `0`, enquanto `equals` devolve `false`.

Lições relacionadas

  • Java · Lição 60 · Intermédio · Versão: 2

Fontes