CKTIS / Java
RoundingMode — pravidla zaokrouhlování desetinných čísel
java.math.RoundingMode určuje pravidlo zaokrouhlování používané mimo jiné v BigDecimal. HALF_UP vybere nejbližší hodnotu a při shodné vzdálenosti zaokrouhluje od nuly, a to i u záporných čísel.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
value.setScale(newScale, RoundingMode.HALF_UP)java.math.RoundingMode je výčtový typ, který určuje pravidlo zaokrouhlování. RoundingMode.HALF_UP vybere nejbližší hodnotu; při shodné vzdálenosti zaokrouhluje od nuly. Při měřítku 2 se 2.345 změní na 2.35 a -2.345 na -2.35.
UP zaokrouhluje od nuly, DOWN směrem k nule, CEILING směrem k plus nekonečnu a FLOOR směrem k minus nekonečnu. HALF_DOWN a HALF_EVEN vybírají nejbližší hodnotu; při shodné vzdálenosti první zaokrouhluje směrem k nule, zatímco druhý volí výsledek, jehož poslední zachovaná číslice je sudá. UNNECESSARY vyžaduje přesný výsledek; pokud je zaokrouhlení nutné, dojde k výjimce ArithmeticException.
U BigDecimal nastavuje setScale(2, RoundingMode.HALF_UP) dvě desetinná místa, nikoli dvě platné číslice. BigDecimal je neměnný: použijte vrácenou hodnotu. Konstruktor s řetězcem, například new BigDecimal("2.345"), zachovává přesnou desetinnou hodnotu; konstruktor s double může způsobit vliv binární reprezentace čísla.
Příklad porovnává HALF_UP s HALF_EVEN a ukazuje, že původní hodnota zůstává nezměněná. Dokumentace se vztahuje k Java SE 21; produkční prostředí není potvrzeno.
Příklady
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);
}
}Výsledek
2.35 -2.35 2.34 2.345
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.