Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

RoundingMode — pravidlá zaokrúhľovania desatinných čísel

java.math.RoundingMode určuje pravidlo zaokrúhľovania používané okrem iného v BigDecimal. HALF_UP vyberie najbližšiu hodnotu a pri rovnakej vzdialenosti zaokrúhľuje od nuly, aj pri záporných číslach.

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

Syntax

value.setScale(newScale, RoundingMode.HALF_UP)

java.math.RoundingMode je výčtový typ, ktorý určuje pravidlo zaokrúhľovania. RoundingMode.HALF_UP vyberie najbližšiu hodnotu; pri rovnakej vzdialenosti zaokrúhľuje od nuly. Pri mierke 2 sa 2.345 zmení na 2.35 a -2.345 na -2.35.

UP zaokrúhľuje od nuly, DOWN smerom k nule, CEILING smerom k plus nekonečnu a FLOOR smerom k mínus nekonečnu. HALF_DOWN a HALF_EVEN vyberajú najbližšiu hodnotu; pri rovnakej vzdialenosti prvý zaokrúhľuje smerom k nule a druhý vyberá výsledok, ktorého posledná zachovaná číslica je párna. UNNECESSARY vyžaduje presný výsledok; ak je zaokrúhlenie potrebné, dôjde k výnimke ArithmeticException.

Pri BigDecimal nastavuje setScale(2, RoundingMode.HALF_UP) dve desatinné miesta, nie dve platné číslice. BigDecimal je nemenný: použite vrátenú hodnotu. Konštruktor s reťazcom, napríklad new BigDecimal("2.345"), zachováva presnú desatinnú hodnotu; konštruktor s double môže priniesť vplyv binárnej reprezentácie čísla.

Príklad porovnáva HALF_UP s HALF_EVEN a ukazuje, že pôvodná hodnota zostáva nezmenená. Dokumentácia sa týka Java SE 21; produkčné prostredie nie je potvrdené.

Prí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ýsledok

2.35
-2.35
2.34
2.345

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje