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.