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.