Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

BigDecimal.subtract — sottrarre valori decimali

Sottrai due valori `BigDecimal` in modo esatto oppure arrotonda la differenza secondo un `MathContext`. Nessuno dei due operandi cambia.

Versione: Java SE 21

Sintassi

public BigDecimal subtract(BigDecimal subtrahend)
public BigDecimal subtract(BigDecimal subtrahend, MathContext mc)

BigDecimal.subtract è un metodo di istanza di java.math.BigDecimal. La chiamata a.subtract(b) calcola a − b: sottrae l’argomento dall’oggetto su cui si chiama il metodo. L’ordine conta. L’operatore - non si applica agli oggetti BigDecimal.

subtract(BigDecimal) restituisce la differenza esatta, senza arrotondamento, con una scala pari a Math.max(a.scale(), b.scale()). Una scala non negativa conta le cifre dopo il separatore decimale, compresi gli zeri finali. BigDecimal è immutabile, quindi nessuno dei due operandi cambia. Salva il valore restituito se ti serve la differenza in seguito.

subtract(BigDecimal, MathContext) arrotonda la differenza esatta se necessario, secondo la precisione e la modalità di arrotondamento del contesto. La precisione conta le cifre significative, non le posizioni decimali. Una precisione di 0, come in MathContext.UNLIMITED, indica un calcolo esatto senza arrotondamento. Se occorre arrotondare ma la modalità è RoundingMode.UNNECESSARY, il metodo lancia ArithmeticException. Passare null come valore da sottrarre o come contesto causa NullPointerException.

Esempi

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

public class Main {
    public static void main(String[] args) {
        BigDecimal a = new BigDecimal("12.30");
        BigDecimal b = new BigDecimal("0.456");

        BigDecimal exact = a.subtract(b);
        BigDecimal rounded = a.subtract(b, new MathContext(3, RoundingMode.HALF_UP));

        System.out.println(exact.toPlainString());
        System.out.println(exact.scale());
        System.out.println(rounded.toPlainString());
        System.out.println(a.toPlainString());
        System.out.println(b.toPlainString());
    }
}

Risultato

11.844
3
11.8
12.30
0.456

I costruttori che accettano stringhe conservano i valori decimali esatti senza passare per `double`. Il programma stampa la differenza esatta `11.844`, la sua scala `3`, il risultato `11.8` arrotondato a tre cifre significative con `HALF_UP` e infine gli operandi invariati `12.30` e `0.456`.

Lezioni correlate

  • Java · Lezione 69 · Base · Versione: 2

Fonti