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

CKTIS / Java

BigDecimal — aritmética decimal e arredondamento

java.math.BigDecimal suporta números decimais de precisão arbitrária, úteis, entre outros casos, em cálculos monetários. Aprende a criar valores, efetuar operações, gerir a escala, comparar e arredondar explicitamente.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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 é um número decimal imutável de precisão arbitrária. BigDecimal(String) cria um valor exato a partir de texto; BigDecimal.valueOf(long) cria um valor a partir de um número inteiro. BigDecimal.valueOf(double) utiliza a representação textual do double, mas não corrige erros de cálculos anteriores. Evita new BigDecimal(0.1) se pretendes representar exatamente 0.1.

BigDecimal.add, BigDecimal.subtract e BigDecimal.multiply efetuam adições, subtrações e multiplicações; conserva o resultado devolvido. BigDecimal.ZERO é zero com escala 0. BigDecimal.compareTo compara valores numéricos, ignorando diferenças de escala; equals tem em conta a escala, pelo que considera 2.0 e 2.00 diferentes.

BigDecimal.divide sem parâmetros de arredondamento exige uma expansão decimal exata e finita. A chamada BigDecimal.ONE.divide(BigDecimal.valueOf(3)) lança uma ArithmeticException porque o quociente exato não tem uma expansão decimal finita. Já a expressão 1 / 3 em Java efetua uma divisão inteira e dá 0. A divisão por zero também lança esta exceção. Indica uma escala e um RoundingMode quando o arredondamento for aceitável. HALF_EVEN escolhe o valor mais próximo e, em caso de empate, o valor cujo último algarismo conservado é par.

BigDecimal.setScale define a escala, não o número de algarismos significativos; reduzir a escala pode exigir arredondamento. Para escalas não negativas, a escala corresponde ao número de casas decimais. BigDecimal.stripTrailingZeros remove zeros finais sem alterar o valor e pode produzir uma escala negativa. BigDecimal.toPlainString apresenta o resultado sem expoente; não é uma formatação monetária dependente da região.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes