CKTIS / Java
Dzielenie BigDecimal z określoną skalą i trybem zaokrąglania
To przeciążenie metody `divide` pozwala podać skalę ilorazu oraz regułę zaokrąglania. Wynik ma wskazaną skalę także wtedy, gdy dzielenie jest dokładne.
Wersja: Java SE 21
Składnia
public BigDecimal divide(BigDecimal divisor, int scale, RoundingMode roundingMode)
BigDecimal quotient = dividend.divide(divisor, scale, roundingMode);dividend.divide(divisor, scale, roundingMode) dzieli dividend przez divisor. Oba argumenty dzielenia są typu java.math.BigDecimal, a metoda zwraca iloraz, nie zmieniając żadnego z nich. Typ int parametru scale określa skalę wyniku, a java.math.RoundingMode wskazuje, jak zaokrąglić iloraz, jeśli jest to potrzebne.
Skala 2 oznacza dwa miejsca po kropce dziesiętnej, łącznie z końcowymi zerami. Skala 0 oznacza wynik bez części ułamkowej, a skala -2 — wielokrotność 100. Skala nie oznacza liczby cyfr znaczących. HALF_UP wybiera najbliższą wartość o danej skali, a w połowie odległości wybiera tę dalszą od zera.
Dzielenie przez zero zgłasza ArithmeticException. Ten sam wyjątek występuje przy UNNECESSARY, jeśli dokładnego ilorazu nie da się zapisać w podanej skali bez zaokrąglenia. Dokładne 0.5 można zapisać w skali 2 jako 0.50 bez zmiany wartości.
divide(divisor, roundingMode) stosuje skalę dzielnej. divide(divisor) wymaga dokładnego wyniku i zgłasza wyjątek, gdy rozwinięcie dziesiętne jest nieskończone. divide(divisor, mathContext) korzysta z precyzji i trybu zaokrąglania z kontekstu zamiast przyjmować zadaną skalę. Starsze przeciążenie z trybem przekazywanym jako int jest przestarzałe; używaj RoundingMode.
Przykłady
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());
}
}Wynik
0.13 0.50
Dokładny iloraz `1 / 8` to `0.125`, więc `HALF_UP` daje `0.13`. Iloraz `1 / 2` nie wymaga zaokrąglenia: `toPlainString()` wypisuje `0.50`, zachowując zero wynikające ze skali `2`.
Powiązane lekcje
- Java · Lekcja 69 · Podstawowy · Wersja: 2