Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

BigDecimal.setScale — cambiare la scala e arrotondare

Imposta la scala di un `BigDecimal` mantenendo il suo valore oppure scegliendo esplicitamente come arrotondarlo. L’oggetto originale non cambia.

Versione: Java SE 21

Sintassi

public BigDecimal setScale(int newScale)
public BigDecimal setScale(int newScale, RoundingMode roundingMode)
@Deprecated(since = "9")
public BigDecimal setScale(int newScale, int roundingMode)

BigDecimal.setScale è un metodo di istanza di java.math.BigDecimal. Una scala non negativa indica il numero di cifre dopo il separatore decimale; la scala -1 corrisponde ai multipli di dieci. La scala non è la precisione (il numero di cifre del valore non scalato). Il metodo restituisce un BigDecimal, non testo formattato. L’oggetto originale è immutabile: usa il valore restituito, che non è necessariamente un nuovo oggetto.

setScale(int) conserva il valore numerico. Nella notazione decimale, aumentare la scala può aggiungere zeri finali; diminuirla senza alterare il valore può eliminare soltanto zeri. Se occorre arrotondare, il metodo lancia ArithmeticException.

setScale(int, RoundingMode) applica la modalità scelta da java.math.RoundingMode se la riduzione della scala richiede un arrotondamento. HALF_UP sceglie il valore più vicino alla scala richiesta e, a parità di distanza, quello più lontano da zero: 2.675 diventa 2.68 con scala 2. UNNECESSARY richiede un risultato esatto e provoca una ArithmeticException se serve un arrotondamento.

L’overload setScale(int, int) è deprecato da Java 9 e lancia IllegalArgumentException se il secondo argomento non indica una modalità di arrotondamento valida. Nel nuovo codice usa l’overload con RoundingMode. Per immettere un decimale esatto, usa new BigDecimal("2.675") anziché new BigDecimal(2.675), che acquisisce l’approssimazione binaria del double.

Esempi

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

public class Main {
    public static void main(String[] args) {
        BigDecimal original = new BigDecimal("2.675");
        BigDecimal padded = original.setScale(4);
        System.out.println(padded.toPlainString());
        System.out.println(padded.setScale(3).toPlainString());
        System.out.println(original.setScale(2, RoundingMode.HALF_UP).toPlainString());

        try {
            original.setScale(2);
        } catch (ArithmeticException e) {
            System.out.println("ArithmeticException");
        }

        System.out.println(original.toPlainString());
    }
}

Risultato

2.6750
2.675
2.68
ArithmeticException
2.675

Le prime due righe mostrano come aggiungere e rimuovere uno zero finale senza cambiare il valore. La terza mostra l’arrotondamento, la quarta segnala l’eccezione intercettata e l’ultima mostra che il valore originale non è cambiato.

Lezioni correlate

  • Java · Lezione 4 · Base · Versione: 2
  • Java · Lezione 6 · Base · Versione: 2
  • Java · Lezione 69 · Base · Versione: 2

Fonti