Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

RoundingMode — reguły zaokrąglania liczb dziesiętnych

java.math.RoundingMode określa regułę zaokrąglania używaną m.in. przez BigDecimal. HALF_UP wybiera najbliższą wartość, a przy remisie zaokrągla od zera, również dla liczb ujemnych.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

value.setScale(newScale, RoundingMode.HALF_UP)

java.math.RoundingMode to typ wyliczeniowy określający sposób zaokrąglania. RoundingMode.HALF_UP wybiera najbliższą wartość; przy remisie wybiera tę dalszą od zera. Przy skali 2 wartość 2.345 daje 2.35, a -2.345 daje -2.35.

UP zaokrągla od zera, DOWN do zera, CEILING w stronę dodatniej nieskończoności, a FLOOR w stronę ujemnej nieskończoności. Tryby HALF_DOWN i HALF_EVEN wybierają najbliższą wartość; przy remisie pierwszy wybiera wartość bliższą zeru, a drugi wynik z parzystą ostatnią zachowaną cyfrą. UNNECESSARY wymaga dokładnego wyniku; konieczność zaokrąglenia powoduje ArithmeticException.

W BigDecimal wywołanie setScale(2, RoundingMode.HALF_UP) ustala dwie cyfry po przecinku, nie dwie cyfry znaczące. BigDecimal jest niemutowalny: należy wykorzystać zwróconą wartość. Konstruktor z tekstem, np. new BigDecimal("2.345"), zachowuje dokładną wartość dziesiętną; konstruktor z double może wprowadzić skutki binarnej reprezentacji liczby.

Przykład porównuje HALF_UP z HALF_EVEN i pokazuje, że wartość pierwotna pozostaje niezmieniona. Zakres dokumentacji to Java SE 21; środowisko produkcyjne nie zostało potwierdzone.

Przykłady

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

public class Main {
    public static void main(String[] args) {
        BigDecimal positive = new BigDecimal("2.345");
        BigDecimal negative = new BigDecimal("-2.345");

        System.out.println(positive.setScale(2, RoundingMode.HALF_UP));
        System.out.println(negative.setScale(2, RoundingMode.HALF_UP));
        System.out.println(positive.setScale(2, RoundingMode.HALF_EVEN));
        System.out.println(positive);
    }
}

Wynik

2.35
-2.35
2.34
2.345

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła