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.