Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

BigDecimal: dokładne obliczenia dziesiętne, skala i porównywanie

Wczytuj liczby dziesiętne bez konwersji na `double`, wykonuj dokładne obliczenia, dobieraj skalę i zaokrąglenie oraz porównuj wartości niezależnie od zapisu.

Wersja: Java SE 21

Składnia

java.math.BigDecimal — Java SE 21

BigDecimal(String val)
BigDecimal add(BigDecimal augend)
BigDecimal multiply(BigDecimal multiplicand)
BigDecimal setScale(int newScale)
BigDecimal setScale(int newScale, RoundingMode roundingMode)
BigDecimal stripTrailingZeros()
int compareTo(BigDecimal val)
String toPlainString()

RoundingMode: java.math.RoundingMode

W Java SE 21 konstruktor BigDecimal(String) z pakietu java.math dokładnie odczytuje liczbę dziesiętną bez pośredniej konwersji na double. Używaj kropki, nie przecinka; białe znaki i separatory grup cyfr są niedozwolone. Niepoprawny zapis powoduje NumberFormatException. Bez wykładnika skala to liczba cyfr po kropce, łącznie z końcowymi zerami; podany wykładnik odejmuje się od tej skali.

Jednoargumentowe metody BigDecimal.add i BigDecimal.multiply zwracają dokładną sumę i dokładny iloczyn. Skala sumy to większa ze skal argumentów działania, a preferowana skala iloczynu to ich suma. W JDK 21, jeśli suma skal wykracza poza zakres typu int, mnożenie może zgłosić ArithmeticException. Jeśli jednak obiekt, na którym wywołano metodę (this), ma wartość zero, metoda zwraca zero ze skalą równą najbliższej granicy zakresu int. Przeciążenia przyjmujące MathContext mogą zaokrąglać zgodnie z kontekstem. Obiekty BigDecimal są niemutowalne: zachowaj zwrócony wynik, bo argumenty działania się nie zmienią.

BigDecimal.setScale ustala skalę wyniku. setScale(int) zgłasza ArithmeticException, jeśli potrzebne byłoby zaokrąglenie; setScale(int, RoundingMode) pozwala wskazać regułę. HALF_UP zaokrągla do najbliższej wartości, a w połowie od zera; UNNECESSARY zgłasza ArithmeticException, jeśli trzeba zaokrąglić. Przeciążenie setScale(int, int) jest przestarzałe.

BigDecimal.stripTrailingZeros usuwa końcowe zera z reprezentacji bez zmiany wartości. Skala może stać się ujemna, jak dla 600.0 po usunięciu zer (skala -2); dla zera metoda zwraca BigDecimal.ZERO. Przekroczenie zakresu skali powoduje ArithmeticException. BigDecimal.toPlainString zwraca tekst bez wykładnika i bez formatowania regionalnego. Aby uzyskać stałą liczbę miejsc po kropce, najpierw ustaw skalę. Ponowne wczytanie tekstu zachowuje wartość, ale niekoniecznie skalę.

BigDecimal.compareTo porównuje wartości liczbowe niezależnie od skali: zwraca -1, 0 lub 1, gdy pierwszy operand jest odpowiednio mniejszy, równy lub większy. Do sprawdzenia równości liczbowej użyj a.compareTo(b) == 0; equals wymaga tej samej wartości i skali, więc dla 2.0 i 2.00 zwraca false.

Przykłady

import java.math.BigDecimal;
import java.math.RoundingMode;

public class Main {
    public static void main(String[] args) {
        BigDecimal unitPrice = new BigDecimal("2.500");
        BigDecimal quantity = new BigDecimal("3");
        BigDecimal fee = new BigDecimal("0.005");
        BigDecimal exact = unitPrice.multiply(quantity).add(fee);
        BigDecimal rounded = exact.setScale(2, RoundingMode.HALF_UP);

        BigDecimal stripped = new BigDecimal("600.0").stripTrailingZeros();
        BigDecimal sameValue = new BigDecimal("600.00");

        System.out.println("exact: " + exact.toPlainString());
        System.out.println("rounded: " + rounded.toPlainString());
        System.out.println("stripped scale: " + stripped.scale());
        System.out.println("plain: " + stripped.toPlainString());
        System.out.println("compareTo: " + stripped.compareTo(sameValue));
        System.out.println("equals: " + stripped.equals(sameValue));
    }
}

Wynik

exact: 7.505
rounded: 7.51
stripped scale: -2
plain: 600
compareTo: 0
equals: false

Dokładny wynik `7.505` zaokrągla się do `7.51`. Po usunięciu zer z `600.0` skala wynosi `-2`, ale zapis bez wykładnika to `600`. Porównanie z `600.00` daje `0`, choć `equals` zwraca `false`.

Powiązane lekcje

  • Java · Lekcja 60 · Średniozaawansowany · Wersja: 2

Źródła