WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

BigDecimal.subtract — Dezimalzahlen subtrahieren

Subtrahiere zwei `BigDecimal`-Werte exakt oder runde die Differenz nach den Einstellungen eines `MathContext`. Beide Operanden bleiben unverändert.

Version: Java SE 21

Syntax

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

BigDecimal.subtract ist eine Instanzmethode von java.math.BigDecimal. Der Aufruf a.subtract(b) berechnet a − b: Er zieht das Argument von dem Objekt ab, auf dem du die Methode aufrufst. Die Reihenfolge spielt eine Rolle. Der Operator - ist auf BigDecimal-Objekte nicht anwendbar.

subtract(BigDecimal) liefert die exakte Differenz ohne Rundung. Ihre Skala ist Math.max(a.scale(), b.scale()). Eine nichtnegative Skala gibt die Zahl der Nachkommastellen einschließlich nachgestellter Nullen an. BigDecimal ist unveränderlich, daher bleiben beide Operanden unverändert. Speichere den Rückgabewert, wenn du die Differenz später brauchst.

subtract(BigDecimal, MathContext) rundet die exakte Differenz bei Bedarf nach der Präzision und dem Rundungsmodus des Kontexts. Die Präzision zählt signifikante Stellen, nicht Nachkommastellen. Eine Präzision von 0, wie bei MathContext.UNLIMITED, bedeutet exaktes Rechnen ohne Rundung. Ist eine Rundung nötig, obwohl der Modus RoundingMode.UNNECESSARY lautet, löst die Methode eine ArithmeticException aus. null als abzuziehender Wert oder als Kontext führt zu einer NullPointerException.

Beispiele

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

Ergebnis

11.844
3
11.8
12.30
0.456

Die Konstruktoren mit Zeichenketten übernehmen die exakten Dezimalwerte ohne Umweg über `double`. Das Programm gibt die exakte Differenz `11.844`, ihre Skala `3`, das mit `HALF_UP` auf drei signifikante Stellen gerundete Ergebnis `11.8` und schließlich die unveränderten Operanden `12.30` und `0.456` aus.

Zugehörige Lektionen

  • Java · Lektion 69 · Grundlagen · Version: 2

Quellen