Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

RoundingMode — pravila zaokroževanja decimalnih števil

java.math.RoundingMode določa pravilo zaokroževanja, ki ga med drugim uporabljajo API-ji, kot je BigDecimal. HALF_UP izbere najbližjo vrednost, ob enaki razdalji pa zaokroži stran od ničle, tudi pri negativnih številih.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

value.setScale(newScale, RoundingMode.HALF_UP)

java.math.RoundingMode je naštevni tip, ki določa pravilo zaokroževanja. RoundingMode.HALF_UP izbere najbližjo vrednost; ob enaki razdalji zaokroži stran od ničle. Pri skali 2 postane 2.345 vrednost 2.35, -2.345 pa -2.35.

UP zaokroži stran od ničle, DOWN proti ničli, CEILING proti pozitivni neskončnosti, FLOOR pa proti negativni neskončnosti. HALF_DOWN in HALF_EVEN izbereta najbližjo vrednost; ob enaki razdalji prvi zaokroži proti ničli, drugi pa izbere rezultat, pri katerem je zadnja ohranjena števka soda. UNNECESSARY zahteva natančen rezultat; če je zaokroževanje potrebno, se sproži ArithmeticException.

Pri BigDecimal setScale(2, RoundingMode.HALF_UP) določi dve decimalni mesti, ne dveh značilnih števk. BigDecimal je nespremenljiv: uporabite vrnjeno vrednost. Konstruktor z nizom, na primer new BigDecimal("2.345"), ohrani natančno decimalno vrednost; konstruktor z double lahko povzroči učinke binarne predstavitve števila.

Primer primerja HALF_UP z HALF_EVEN in pokaže, da izvirna vrednost ostane nespremenjena. Dokumentacija se nanaša na Java SE 21; produkcijsko okolje ni potrjeno.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri