Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

BigDecimal — aritmetica decimale e arrotondamento

java.math.BigDecimal supporta numeri decimali a precisione arbitraria, utili tra l’altro nei calcoli monetari. Scopri come creare valori, eseguire operazioni, gestire la scala, confrontare e arrotondare in modo esplicito.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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 è un numero decimale immutabile a precisione arbitraria. BigDecimal(String) crea un valore esatto a partire da testo; BigDecimal.valueOf(long) lo crea da un intero. BigDecimal.valueOf(double) usa la rappresentazione testuale del double, ma non può correggere errori di calcolo precedenti. Evita new BigDecimal(0.1) se vuoi rappresentare esattamente 0.1.

BigDecimal.add, BigDecimal.subtract e BigDecimal.multiply eseguono addizioni, sottrazioni e moltiplicazioni; conserva il risultato restituito. BigDecimal.ZERO è zero con scala 0. BigDecimal.compareTo confronta i valori numerici ignorando le differenze di scala; equals tiene conto della scala, quindi considera diversi 2.0 e 2.00.

BigDecimal.divide senza parametri di arrotondamento richiede un’espansione decimale esatta e finita. La chiamata BigDecimal.ONE.divide(BigDecimal.valueOf(3)) genera una ArithmeticException perché il quoziente esatto non ha un’espansione decimale finita. In Java, invece, l’espressione 1 / 3 esegue una divisione intera e restituisce 0. Anche la divisione per zero genera questa eccezione. Specifica una scala e un RoundingMode quando l’arrotondamento è accettabile. HALF_EVEN sceglie il valore più vicino e, in caso di parità, quello la cui ultima cifra mantenuta è pari.

BigDecimal.setScale imposta la scala, non il numero di cifre significative; ridurre la scala può richiedere un arrotondamento. Per scale non negative, la scala è il numero di cifre decimali. BigDecimal.stripTrailingZeros rimuove gli zeri finali senza modificare il valore e può produrre una scala negativa. BigDecimal.toPlainString rende il risultato senza esponente; non è una formattazione monetaria dipendente dalle impostazioni locali.

Esempi

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());
    }
}

Risultato

38.50
12.83
true
12.5

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti