WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

RoundingMode — Rundungsregeln für Dezimalzahlen

java.math.RoundingMode legt die Rundungsregel fest, die unter anderem von BigDecimal verwendet wird. HALF_UP wählt den nächstliegenden Wert und rundet bei einem Gleichstand von null weg, auch bei negativen Zahlen.

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

Syntax

value.setScale(newScale, RoundingMode.HALF_UP)

java.math.RoundingMode ist ein Enum, das die Rundungsart festlegt. RoundingMode.HALF_UP wählt den nächstliegenden Wert; bei einem Gleichstand wird von null weg gerundet. Bei Skala 2 wird 2.345 zu 2.35 und -2.345 zu -2.35.

UP rundet von null weg, DOWN in Richtung null, CEILING in Richtung positive Unendlichkeit und FLOOR in Richtung negative Unendlichkeit. HALF_DOWN und HALF_EVEN wählen den nächstliegenden Wert; bei einem Gleichstand rundet der erste in Richtung null, der zweite so, dass die letzte beibehaltene Ziffer gerade ist. UNNECESSARY verlangt ein exaktes Ergebnis; erforderliches Runden löst eine ArithmeticException aus.

Bei BigDecimal legt setScale(2, RoundingMode.HALF_UP) zwei Nachkommastellen fest, nicht zwei signifikante Stellen. BigDecimal ist unveränderlich: Verwenden Sie den zurückgegebenen Wert. Ein String-Konstruktor wie new BigDecimal("2.345") bewahrt den exakten Dezimalwert; ein Konstruktor mit double kann Auswirkungen der binären Zahlendarstellung mit sich bringen.

Das Beispiel vergleicht HALF_UP mit HALF_EVEN und zeigt, dass der ursprüngliche Wert unverändert bleibt. Die Dokumentation bezieht sich auf Java SE 21; die Produktionslaufzeit ist nicht bestätigt.

Beispiele

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

public class Main {
    public static void main(String[] args) {
        BigDecimal positive = new BigDecimal("2.345");
        BigDecimal negative = new BigDecimal("-2.345");

        System.out.println(positive.setScale(2, RoundingMode.HALF_UP));
        System.out.println(negative.setScale(2, RoundingMode.HALF_UP));
        System.out.println(positive.setScale(2, RoundingMode.HALF_EVEN));
        System.out.println(positive);
    }
}

Ergebnis

2.35
-2.35
2.34
2.345

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