Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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