WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen