KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

RoundingMode — afrondingsregels voor decimalen

java.math.RoundingMode bepaalt een afrondingsregel die onder andere door BigDecimal wordt gebruikt. HALF_UP kiest de dichtstbijzijnde waarde en rondt bij een gelijke afstand van nul af, ook bij negatieve getallen.

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

Syntax

value.setScale(newScale, RoundingMode.HALF_UP)

java.math.RoundingMode is een enum die een afrondingsregel vastlegt. RoundingMode.HALF_UP kiest de dichtstbijzijnde waarde; bij gelijke afstand wordt van nul af afgerond. Bij schaal 2 wordt 2.345 2.35 en -2.345 wordt -2.35.

UP rondt van nul af, DOWN naar nul toe, CEILING richting positieve oneindigheid en FLOOR richting negatieve oneindigheid. HALF_DOWN en HALF_EVEN kiezen de dichtstbijzijnde waarde; bij gelijke afstand rondt de eerste naar nul toe en kiest de tweede een resultaat met een even laatste behouden cijfer. UNNECESSARY vereist een exact resultaat; als afronden nodig is, wordt een ArithmeticException veroorzaakt.

Voor BigDecimal stelt setScale(2, RoundingMode.HALF_UP) twee decimalen in, niet twee significante cijfers. BigDecimal is onveranderlijk: gebruik de geretourneerde waarde. Een constructor met een tekenreeks, zoals new BigDecimal("2.345"), behoudt de exacte decimale waarde; een constructor met double kan effecten van de binaire getalrepresentatie introduceren.

Het voorbeeld vergelijkt HALF_UP met HALF_EVEN en laat zien dat de oorspronkelijke waarde ongewijzigd blijft. De documentatie betreft Java SE 21; de productieomgeving is niet bevestigd.

Voorbeelden

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);
    }
}

Resultaat

2.35
-2.35
2.34
2.345

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen