CKTIS / Java
BigDecimal.setScale — Skala ändern und runden
Lege die Skala eines `BigDecimal` fest: Erhalte den Zahlenwert oder wähle ausdrücklich einen Rundungsmodus. Das ursprüngliche Objekt bleibt unverändert.
Version: Java SE 21
Syntax
public BigDecimal setScale(int newScale)
public BigDecimal setScale(int newScale, RoundingMode roundingMode)
@Deprecated(since = "9")
public BigDecimal setScale(int newScale, int roundingMode)BigDecimal.setScale ist eine Instanzmethode von java.math.BigDecimal. Eine nichtnegative Skala gibt die Anzahl der Nachkommastellen an; bei Skala -1 sind die darstellbaren Werte Vielfache von zehn. Die Skala ist nicht die Präzision (Anzahl der Ziffern des unskalierten Werts). Die Methode liefert ein BigDecimal, keinen formatierten Text. Das ursprüngliche Objekt ist unveränderlich. Verwende deshalb den Rückgabewert; dafür muss kein neues Objekt erzeugt werden.
setScale(int) erhält den Zahlenwert. In Dezimalschreibweise kann eine größere Skala Nullen am Ende ergänzen; eine exakte Verringerung kann nur Nullen entfernen. Wäre eine Rundung nötig, löst die Methode eine ArithmeticException aus.
setScale(int, RoundingMode) verwendet den gewählten Modus aus java.math.RoundingMode, wenn beim Verringern der Skala gerundet werden muss. HALF_UP wählt den nächstgelegenen Wert in der Zielskala; bei gleichem Abstand wird von null weg gerundet. So wird 2.675 bei Skala 2 zu 2.68. UNNECESSARY verlangt ein exaktes Ergebnis und führt zu einer ArithmeticException, wenn eine Rundung nötig wäre.
Die Überladung setScale(int, int) ist seit Java 9 veraltet und löst eine IllegalArgumentException aus, wenn das zweite Argument keinen gültigen Rundungsmodus angibt. Verwende in neuem Code die Überladung mit RoundingMode. Verwende für eine exakte Dezimaleingabe new BigDecimal("2.675") statt new BigDecimal(2.675), das die binäre double-Näherung übernimmt.
Beispiele
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal original = new BigDecimal("2.675");
BigDecimal padded = original.setScale(4);
System.out.println(padded.toPlainString());
System.out.println(padded.setScale(3).toPlainString());
System.out.println(original.setScale(2, RoundingMode.HALF_UP).toPlainString());
try {
original.setScale(2);
} catch (ArithmeticException e) {
System.out.println("ArithmeticException");
}
System.out.println(original.toPlainString());
}
}Ergebnis
2.6750 2.675 2.68 ArithmeticException 2.675
Die ersten beiden Zeilen zeigen, wie eine abschließende Null ergänzt und entfernt wird, ohne den Zahlenwert zu ändern. Die dritte zeigt die Rundung, die vierte meldet die abgefangene Ausnahme, und die letzte zeigt den unveränderten Ausgangswert.
Zugehörige Lektionen
- Java · Lektion 4 · Grundlagen · Version: 2
- Java · Lektion 6 · Grundlagen · Version: 2
- Java · Lektion 69 · Grundlagen · Version: 2