CKTIS / Java
BigDecimal: calcolo decimale esatto, scala e confronto
Leggi valori decimali senza passare per `double`, esegui calcoli esatti, scegli scala e regola di arrotondamento e confronta numeri indipendentemente dalla scala.
Versione: Java SE 21
Sintassi
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.RoundingModeIn Java SE 21, il costruttore BigDecimal(String) del package java.math legge esattamente un valore decimale senza passare per double. Usa il punto decimale, non la virgola: spazi e separatori tra gruppi di cifre non sono ammessi. Una stringa non valida causa NumberFormatException. Senza esponente, la scala conta le cifre dopo il punto, compresi gli zeri finali; un esponente esplicito viene sottratto da tale scala.
I metodi a un argomento BigDecimal.add e BigDecimal.multiply restituiscono la somma e il prodotto esatti. La somma usa la scala maggiore dei due operandi; la scala preferita del prodotto è la somma delle loro scale. In JDK 21, se questa somma non rientra nell’intervallo di int, la moltiplicazione può generare ArithmeticException. Se l’oggetto su cui viene chiamato il metodo (this) vale zero, il metodo restituisce invece zero con la scala limitata all’estremo più vicino dell’intervallo. Gli overload con MathContext possono arrotondare secondo il contesto. Gli oggetti BigDecimal sono immutabili: conserva il risultato restituito, perché gli operandi non cambiano.
BigDecimal.setScale imposta la scala del risultato. setScale(int) genera ArithmeticException se occorre arrotondare; setScale(int, RoundingMode) consente di scegliere la regola. HALF_UP arrotonda al valore più vicino e, in caso di parità, lontano da zero. UNNECESSARY genera ArithmeticException se occorre arrotondare. L’overload setScale(int, int) è deprecato.
BigDecimal.stripTrailingZeros elimina gli zeri finali dalla rappresentazione senza cambiare il valore. La scala può diventare negativa, come accade con 600.0 dopo la rimozione (scala -2); per zero restituisce BigDecimal.ZERO. Se la scala supera i limiti consentiti, viene generata ArithmeticException. BigDecimal.toPlainString restituisce testo senza esponente né formattazione locale. Per avere un numero fisso di cifre decimali, imposta prima la scala. Rileggendo il testo si conserva il valore, ma non necessariamente la scala.
BigDecimal.compareTo confronta i numeri a prescindere dalla scala: restituisce -1, 0 o 1 se il primo operando è rispettivamente minore, uguale o maggiore del secondo. Usa a.compareTo(b) == 0 per verificare l’uguaglianza numerica; equals richiede lo stesso valore e la stessa scala, quindi restituisce false per 2.0 e 2.00.
Esempi
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));
}
}Risultato
exact: 7.505 rounded: 7.51 stripped scale: -2 plain: 600 compareTo: 0 equals: false
Il risultato esatto `7.505` viene arrotondato a `7.51`. Eliminando gli zeri da `600.0` si ottiene scala `-2`, ma il testo senza esponente è `600`. Il confronto con `600.00` dà `0`, mentre `equals` restituisce `false`.
Lezioni correlate
- Java · Lezione 60 · Intermedio · Versione: 2