Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

BigDecimal.setScale — zmiana skali i zaokrąglanie

Ustaw skalę liczby `BigDecimal`, zachowując jej wartość lub jawnie wybierając tryb zaokrąglania. Wywołanie nie zmienia obiektu źródłowego.

Wersja: Java SE 21

Składnia

public BigDecimal setScale(int newScale)
public BigDecimal setScale(int newScale, RoundingMode roundingMode)
@Deprecated(since = "9")
public BigDecimal setScale(int newScale, int roundingMode)

BigDecimal.setScale to metoda instancji klasy java.math.BigDecimal. Dla skali nieujemnej skala oznacza liczbę miejsc po kropce dziesiętnej; skala -1 oznacza wielokrotności dziesięciu. Skala to nie precyzja (liczba cyfr wartości nieskalowanej). Metoda zwraca BigDecimal, a nie sformatowany tekst. Obiekt źródłowy jest niemodyfikowalny, więc użyj zwróconej wartości; metoda nie musi tworzyć nowego obiektu.

setScale(int) zachowuje wartość liczbową. W zapisie dziesiętnym zwiększenie skali może dopisać końcowe zera, a zmniejszenie skali bez zmiany wartości może usunąć tylko zera. Jeżeli konieczne byłoby zaokrąglenie, metoda zgłasza ArithmeticException.

setScale(int, RoundingMode) stosuje wybrany tryb z java.math.RoundingMode, gdy zmniejszenie skali wymaga zaokrąglenia. HALF_UP wybiera najbliższą wartość w zadanej skali, a w połowie drogi zaokrągla od zera: 2.675 daje 2.68 przy skali 2. UNNECESSARY wymaga wyniku dokładnego; jeśli zaokrąglenie jest konieczne, zgłaszany jest ArithmeticException.

Przeciążenie setScale(int, int) jest przestarzałe od Javy 9 i zgłasza IllegalArgumentException, jeśli drugi argument nie oznacza prawidłowego trybu zaokrąglania. W nowym kodzie używaj przeciążenia z RoundingMode. Aby wprowadzić dokładną liczbę dziesiętną, użyj new BigDecimal("2.675"), a nie new BigDecimal(2.675), które przejmuje binarne przybliżenie typu double.

Przykłady

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

public class Main {
    public static void main(String[] args) {
        BigDecimal original = new BigDecimal("2.675");
        BigDecimal padded = original.setScale(4);
        System.out.println(padded.toPlainString());
        System.out.println(padded.setScale(3).toPlainString());
        System.out.println(original.setScale(2, RoundingMode.HALF_UP).toPlainString());

        try {
            original.setScale(2);
        } catch (ArithmeticException e) {
            System.out.println("ArithmeticException");
        }

        System.out.println(original.toPlainString());
    }
}

Wynik

2.6750
2.675
2.68
ArithmeticException
2.675

Pierwsze dwa wiersze pokazują dopisanie i usunięcie końcowego zera bez zmiany wartości. Trzeci pokazuje zaokrąglenie, czwarty sygnalizuje przechwycony wyjątek, a ostatni pokazuje niezmieniony oryginał.

Powiązane lekcje

  • Java · Lekcja 4 · Podstawowy · Wersja: 2
  • Java · Lekcja 6 · Podstawowy · Wersja: 2
  • Java · Lekcja 69 · Podstawowy · Wersja: 2

Źródła