Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje