CKTIS / Java
RoundingMode — pravila zaokruživanja decimalnih brojeva
java.math.RoundingMode određuje pravilo zaokruživanja koje, među ostalim, upotrebljava BigDecimal. HALF_UP odabire najbližu vrijednost, a u slučaju jednake udaljenosti zaokružuje od nule, uključujući negativne brojeve.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
value.setScale(newScale, RoundingMode.HALF_UP)java.math.RoundingMode je enumerirani tip koji određuje pravilo zaokruživanja. RoundingMode.HALF_UP odabire najbližu vrijednost; u slučaju jednake udaljenosti zaokružuje od nule. Pri skali 2, 2.345 postaje 2.35, a -2.345 postaje -2.35.
UP zaokružuje od nule, DOWN prema nuli, CEILING prema pozitivnoj beskonačnosti, a FLOOR prema negativnoj beskonačnosti. HALF_DOWN i HALF_EVEN odabiru najbližu vrijednost; u slučaju jednake udaljenosti prvi zaokružuje prema nuli, a drugi odabire rezultat čija je posljednja zadržana znamenka parna. UNNECESSARY zahtijeva točan rezultat; ako je zaokruživanje potrebno, dolazi do iznimke ArithmeticException.
Za BigDecimal, setScale(2, RoundingMode.HALF_UP) postavlja dva decimalna mjesta, a ne dvije značajne znamenke. BigDecimal je nepromjenjiv: upotrijebite vraćenu vrijednost. Konstruktor koji prima niz, primjerice new BigDecimal("2.345"), čuva točnu decimalnu vrijednost; konstruktor koji prima double može uvesti učinke binarnog prikaza broja.
Primjer uspoređuje HALF_UP s HALF_EVEN i pokazuje da izvorna vrijednost ostaje nepromijenjena. Dokumentacija se odnosi na Java SE 21; produkcijsko okruženje nije potvrđeno.
Primjeri
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);
}
}Rezultat
2.35 -2.35 2.34 2.345
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.