WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

BigDecimal: exakte Dezimalrechnung, Skala und Vergleich

Dezimalzahlen ohne Umweg über `double` einlesen, exakt rechnen, Skala und Rundungsregel wählen und Zahlen unabhängig von ihrer Skala vergleichen.

Version: Java SE 21

Syntax

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.RoundingMode

In Java SE 21 liest der Konstruktor BigDecimal(String) aus java.math einen Dezimalwert exakt ein, ohne ihn zuvor in double umzuwandeln. Verwende einen Dezimalpunkt statt eines Kommas; Leerraum und Zifferngruppentrennzeichen sind nicht erlaubt. Ungültiger Text löst eine NumberFormatException aus. Ohne Exponenten zählt die Skala die Ziffern nach dem Punkt einschließlich abschließender Nullen. Ein angegebener Exponent wird von dieser Skala abgezogen.

Die Methoden BigDecimal.add und BigDecimal.multiply liefern mit je einem Argument die exakte Summe bzw. das exakte Produkt. Die Summe übernimmt die größere Skala der Operanden; die bevorzugte Skala des Produkts ist die Summe der Operandenskalen. Liegt diese Summe außerhalb des int-Wertebereichs, kann die Multiplikation in JDK 21 eine ArithmeticException auslösen. Hat das Objekt, auf dem die Methode aufgerufen wird (this), den Wert null, gibt die Methode stattdessen null zurück und begrenzt die Skala auf die nächstgelegene int-Grenze. Überladungen mit MathContext können gemäß diesem Kontext runden. BigDecimal-Objekte sind unveränderlich: Verwende den Rückgabewert, denn die Operanden bleiben unverändert.

BigDecimal.setScale legt die Skala des Ergebnisses fest. setScale(int) löst eine ArithmeticException aus, wenn gerundet werden müsste; bei setScale(int, RoundingMode) wählst du die Rundungsregel. HALF_UP rundet auf den nächstgelegenen Wert, genau in der Mitte von null weg. UNNECESSARY löst eine ArithmeticException aus, wenn Rundung nötig ist. Die Überladung setScale(int, int) ist veraltet.

BigDecimal.stripTrailingZeros entfernt abschließende Nullen aus der Darstellung, ohne den Wert zu ändern. Dabei kann die Skala negativ werden, etwa bei 600.0 (Skala -2); für null liefert die Methode BigDecimal.ZERO. Ein Überlauf der Skala löst eine ArithmeticException aus. BigDecimal.toPlainString liefert Text ohne Exponenten und ohne landesspezifische Formatierung. Für eine feste Zahl von Nachkommastellen stellst du zuerst die Skala ein. Beim erneuten Einlesen bleibt der Wert erhalten, aber nicht unbedingt die Skala.

BigDecimal.compareTo vergleicht Zahlen unabhängig von ihrer Skala: Ist der erste Operand kleiner, gleich oder größer, ergibt sich entsprechend -1, 0 oder 1. Verwende a.compareTo(b) == 0 für numerische Gleichheit. equals verlangt denselben Wert und dieselbe Skala und liefert deshalb für 2.0 und 2.00 den Wert false.

Beispiele

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

Ergebnis

exact: 7.505
rounded: 7.51
stripped scale: -2
plain: 600
compareTo: 0
equals: false

Das exakte Ergebnis `7.505` wird auf `7.51` gerundet. Nach dem Entfernen der Nullen aus `600.0` ist die Skala `-2`, der Text ohne Exponenten lautet aber `600`. Der Vergleich mit `600.00` ergibt `0`, während `equals` den Wert `false` liefert.

Zugehörige Lektionen

  • Java · Lektion 60 · Mittlere Stufe · Version: 2

Quellen