CKTIS / Java
BigDecimal — arytmetyka dziesiętna i zaokrąglanie
java.math.BigDecimal obsługuje liczby dziesiętne o dowolnej precyzji, przydatne między innymi w obliczeniach pieniężnych. Poznaj tworzenie wartości, działania, skalę, porównywanie i jawne zaokrąglanie.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
new BigDecimal("12.50"); BigDecimal.valueOf(3); a.add(b); a.subtract(b); a.multiply(b); a.divide(b, 2, RoundingMode.HALF_EVEN); a.setScale(2, RoundingMode.HALF_EVEN); a.compareTo(BigDecimal.ZERO); a.stripTrailingZeros().toPlainString();java.math.BigDecimal jest niemutowalną liczbą dziesiętną o dowolnej precyzji. BigDecimal(String) tworzy dokładną wartość z tekstu; BigDecimal.valueOf(long) — z liczby całkowitej. BigDecimal.valueOf(double) korzysta z reprezentacji tekstowej double, ale nie naprawia wcześniejszych błędów obliczeń. Unikaj new BigDecimal(0.1), jeśli zamierzasz zapisać dokładnie 0.1.
BigDecimal.add, BigDecimal.subtract i BigDecimal.multiply dodają, odejmują i mnożą; zachowuj zwrócony wynik. BigDecimal.ZERO oznacza zero o skali 0. BigDecimal.compareTo porównuje wartości liczbowo, ignorując różnice skali; equals uwzględnia skalę, więc 2.0 i 2.00 nie są według niego równe.
BigDecimal.divide bez parametrów zaokrąglania wymaga dokładnego, skończonego rozwinięcia dziesiętnego. Wywołanie BigDecimal.ONE.divide(BigDecimal.valueOf(3)) zgłasza ArithmeticException, ponieważ dokładny iloraz nie ma skończonego rozwinięcia dziesiętnego. Natomiast wyrażenie 1 / 3 w Javie wykonuje dzielenie całkowite i daje 0. Dzielenie przez zero również zgłasza ten wyjątek. Podaj skalę i RoundingMode, gdy dopuszczasz zaokrąglenie. HALF_EVEN wybiera najbliższą wartość, a przy remisie tę z parzystą ostatnią zachowaną cyfrą.
BigDecimal.setScale ustala skalę, nie liczbę cyfr znaczących; przy zmniejszaniu skali może wymagać zaokrąglenia. Dla nieujemnej skali jest to liczba miejsc po kropce. BigDecimal.stripTrailingZeros usuwa końcowe zera bez zmiany wartości i może dać skalę ujemną. BigDecimal.toPlainString zapisuje wynik bez wykładnika; nie jest formatowaniem walutowym zależnym od lokalizacji.
Przykłady
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal price = new BigDecimal("12.50");
BigDecimal total = price.multiply(BigDecimal.valueOf(3))
.add(new BigDecimal("2.00"))
.subtract(new BigDecimal("1.00"))
.setScale(2, RoundingMode.HALF_EVEN);
BigDecimal share = total.divide(BigDecimal.valueOf(3), 2,
RoundingMode.HALF_EVEN);
System.out.println(total.toPlainString());
System.out.println(share.toPlainString());
System.out.println(total.compareTo(BigDecimal.ZERO) > 0);
System.out.println(new BigDecimal("12.500")
.stripTrailingZeros().toPlainString());
}
}Wynik
38.50 12.83 true 12.5
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.
Źródła
- java.math (Java SE 21 & JDK 21)
- BigDecimal (Java SE 21 & JDK 21)
- RoundingMode (Java SE 21 & JDK 21)
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html