CKTIS / Java
BigDecimal-Division mit vorgegebener Skala und Rundung
Mit dieser Überladung von `divide` legst du die Skala des Quotienten und die Rundungsregel fest. Auch ein exaktes Ergebnis hat die vorgegebene Skala.
Version: Java SE 21
Syntax
public BigDecimal divide(BigDecimal divisor, int scale, RoundingMode roundingMode)
BigDecimal quotient = dividend.divide(divisor, scale, roundingMode);dividend.divide(divisor, scale, roundingMode) teilt dividend durch divisor. Beide Operanden sind vom Typ java.math.BigDecimal und bleiben unverändert. Das Argument scale vom Typ int legt die Skala des Ergebnisses fest. Das Argument vom Typ java.math.RoundingMode bestimmt, wie bei Bedarf gerundet wird.
Die Skala 2 bedeutet zwei Stellen nach dem Dezimalpunkt, einschließlich nachgestellter Nullen. Bei Skala 0 ist das Ergebnis ganzzahlig, bei Skala -2 ein Vielfaches von 100. Die Skala ist nicht die Anzahl signifikanter Stellen. HALF_UP wählt den nächstgelegenen Wert mit der gewünschten Skala und rundet bei Gleichstand von null weg.
Eine Division durch null löst eine ArithmeticException aus. Dasselbe gilt bei UNNECESSARY, wenn sich der exakte Quotient mit der gewünschten Skala nicht ohne Rundung darstellen lässt. Der exakte Wert 0.5 lässt sich bei Skala 2 ohne Wertänderung als 0.50 darstellen.
divide(divisor, roundingMode) verwendet die Skala des Dividenden. divide(divisor) verlangt ein exaktes Ergebnis und löst bei einer nicht endenden Dezimalentwicklung eine Ausnahme aus. divide(divisor, mathContext) nutzt Präzision und Rundungsmodus aus dem Kontext statt einer vorgegebenen Skala. Die ältere Überladung mit einem Rundungsmodus vom Typ int ist veraltet; verwende stattdessen RoundingMode.
Beispiele
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal one = BigDecimal.ONE;
BigDecimal rounded = one.divide(BigDecimal.valueOf(8), 2, RoundingMode.HALF_UP);
BigDecimal exact = one.divide(BigDecimal.valueOf(2), 2, RoundingMode.HALF_UP);
System.out.println(rounded.toPlainString());
System.out.println(exact.toPlainString());
}
}Ergebnis
0.13 0.50
Der exakte Quotient von `1 / 8` ist `0.125`; mit `HALF_UP` ergibt sich `0.13`. Bei `1 / 2` ist keine Rundung nötig: `toPlainString()` gibt `0.50` aus und behält die durch Skala `2` vorgegebene letzte Null bei.
Zugehörige Lektionen
- Java · Lektion 69 · Grundlagen · Version: 2