WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

BigDecimal — Dezimalarithmetik und Rundung

java.math.BigDecimal unterstützt Dezimalzahlen mit beliebiger Genauigkeit und eignet sich unter anderem für Geldberechnungen. Lerne das Erzeugen von Werten, Rechenoperationen, Skalierung, Vergleiche und explizites Runden kennen.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

new BigDecimal("12.50"); BigDecimal.valueOf(3); a.add(b); a.subtract(b); a.multiply(b); a.divide(b, 2, RoundingMode.HALF_EVEN); a.setScale(2, RoundingMode.HALF_EVEN); a.compareTo(BigDecimal.ZERO); a.stripTrailingZeros().toPlainString();

java.math.BigDecimal ist eine unveränderliche Dezimalzahl mit beliebiger Genauigkeit. BigDecimal(String) erzeugt aus Text einen exakten Wert; BigDecimal.valueOf(long) erzeugt einen Wert aus einer Ganzzahl. BigDecimal.valueOf(double) verwendet die Textdarstellung des double, kann aber frühere Rechenfehler nicht beheben. Vermeide new BigDecimal(0.1), wenn du genau 0.1 darstellen möchtest.

BigDecimal.add, BigDecimal.subtract und BigDecimal.multiply addieren, subtrahieren und multiplizieren; verwende den zurückgegebenen Wert weiter. BigDecimal.ZERO ist null mit Skalierung 0. BigDecimal.compareTo vergleicht Zahlenwerte und ignoriert Unterschiede in der Skalierung; equals berücksichtigt die Skalierung, daher sind 2.0 und 2.00 für diese Methode nicht gleich.

BigDecimal.divide ohne Rundungsparameter erfordert eine exakte, endliche Dezimaldarstellung. Der Aufruf BigDecimal.ONE.divide(BigDecimal.valueOf(3)) löst eine ArithmeticException aus, weil der exakte Quotient keine endliche Dezimaldarstellung hat. Dagegen führt der Java-Ausdruck 1 / 3 eine Ganzzahldivision durch und ergibt 0. Auch eine Division durch null löst diese Ausnahme aus. Gib eine Skalierung und einen RoundingMode an, wenn Runden zulässig ist. HALF_EVEN wählt den nächstgelegenen Wert und entscheidet bei Gleichstand zugunsten des Werts, dessen letzte beibehaltene Ziffer gerade ist.

BigDecimal.setScale legt die Skalierung fest, nicht die Anzahl signifikanter Stellen; eine Verringerung der Skalierung kann Runden erfordern. Bei nichtnegativer Skalierung entspricht sie der Anzahl der Nachkommastellen. BigDecimal.stripTrailingZeros entfernt nachgestellte Nullen, ohne den Wert zu ändern, und kann eine negative Skalierung ergeben. BigDecimal.toPlainString gibt das Ergebnis ohne Exponent aus; es ist keine lokalisierte Währungsformatierung.

Beispiele

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

public class Main {
    public static void main(String[] args) {
        BigDecimal price = new BigDecimal("12.50");
        BigDecimal total = price.multiply(BigDecimal.valueOf(3))
                .add(new BigDecimal("2.00"))
                .subtract(new BigDecimal("1.00"))
                .setScale(2, RoundingMode.HALF_EVEN);
        BigDecimal share = total.divide(BigDecimal.valueOf(3), 2,
                RoundingMode.HALF_EVEN);

        System.out.println(total.toPlainString());
        System.out.println(share.toPlainString());
        System.out.println(total.compareTo(BigDecimal.ZERO) > 0);
        System.out.println(new BigDecimal("12.500")
                .stripTrailingZeros().toPlainString());
    }
}

Ergebnis

38.50
12.83
true
12.5

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen