KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

BigDecimal: exact rekenen, schaal en vergelijken

Lees decimale getallen zonder omzetting via `double`, reken exact, kies een schaal en afrondingsregel en vergelijk getallen onafhankelijk van hun schaal.

Versie: Java SE 21

Syntax

java.math.BigDecimal — Java SE 21

BigDecimal(String val)
BigDecimal add(BigDecimal augend)
BigDecimal multiply(BigDecimal multiplicand)
BigDecimal setScale(int newScale)
BigDecimal setScale(int newScale, RoundingMode roundingMode)
BigDecimal stripTrailingZeros()
int compareTo(BigDecimal val)
String toPlainString()

RoundingMode: java.math.RoundingMode

In Java SE 21 leest de constructor BigDecimal(String) uit java.math een decimale waarde exact in, zonder tussenstap via double. Gebruik een decimale punt, geen komma; witruimte en scheidingstekens tussen cijfergroepen zijn niet toegestaan. Ongeldige tekst leidt tot NumberFormatException. Zonder exponent telt de schaal de cijfers na de punt, inclusief afsluitende nullen; een expliciete exponent wordt van die schaal afgetrokken.

De methoden BigDecimal.add en BigDecimal.multiply met één argument geven de exacte som en het exacte product terug. De som krijgt de grootste schaal van de operanden; de voorkeursschaal van het product is de som van hun schalen. In JDK 21 kan de vermenigvuldiging een ArithmeticException gooien als die som buiten het bereik van int valt. Als het object waarop je de methode aanroept (this) de waarde nul heeft, geeft de methode in plaats daarvan nul terug, met de schaal begrensd op de dichtstbijzijnde grens van het int-bereik. Overloads met MathContext kunnen volgens die context afronden. BigDecimal-objecten zijn onveranderlijk: gebruik het teruggegeven resultaat, want de operanden veranderen niet.

BigDecimal.setScale stelt de schaal van het resultaat in. setScale(int) gooit een ArithmeticException als afronding nodig is; met setScale(int, RoundingMode) kies je een regel. HALF_UP rondt af naar de dichtstbijzijnde waarde en bij gelijke afstand van nul af. UNNECESSARY gooit een ArithmeticException als afronding nodig is. De overload setScale(int, int) is verouderd.

BigDecimal.stripTrailingZeros verwijdert afsluitende nullen uit de weergave zonder de waarde te veranderen. De schaal kan negatief worden, zoals bij 600.0 na het verwijderen (schaal -2); voor nul geeft de methode BigDecimal.ZERO terug. Overschrijding van het schaalbereik leidt tot ArithmeticException. BigDecimal.toPlainString geeft tekst zonder exponent of regiospecifieke opmaak. Stel eerst de schaal in voor een vast aantal decimalen. Bij opnieuw inlezen blijft de waarde behouden, maar niet noodzakelijk de schaal.

BigDecimal.compareTo vergelijkt getallen ongeacht hun schaal: de uitkomst is -1, 0 of 1 als de eerste operand kleiner is dan, gelijk is aan of groter is dan de tweede. Gebruik a.compareTo(b) == 0 voor numerieke gelijkheid; equals vereist dezelfde waarde én schaal en geeft dus false terug voor 2.0 en 2.00.

Voorbeelden

import java.math.BigDecimal;
import java.math.RoundingMode;

public class Main {
    public static void main(String[] args) {
        BigDecimal unitPrice = new BigDecimal("2.500");
        BigDecimal quantity = new BigDecimal("3");
        BigDecimal fee = new BigDecimal("0.005");
        BigDecimal exact = unitPrice.multiply(quantity).add(fee);
        BigDecimal rounded = exact.setScale(2, RoundingMode.HALF_UP);

        BigDecimal stripped = new BigDecimal("600.0").stripTrailingZeros();
        BigDecimal sameValue = new BigDecimal("600.00");

        System.out.println("exact: " + exact.toPlainString());
        System.out.println("rounded: " + rounded.toPlainString());
        System.out.println("stripped scale: " + stripped.scale());
        System.out.println("plain: " + stripped.toPlainString());
        System.out.println("compareTo: " + stripped.compareTo(sameValue));
        System.out.println("equals: " + stripped.equals(sameValue));
    }
}

Resultaat

exact: 7.505
rounded: 7.51
stripped scale: -2
plain: 600
compareTo: 0
equals: false

Het exacte resultaat `7.505` wordt afgerond naar `7.51`. Na het verwijderen van de nullen uit `600.0` is de schaal `-2`, maar de tekst zonder exponent is `600`. De vergelijking met `600.00` geeft `0`, terwijl `equals` het resultaat `false` geeft.

Gerelateerde lessen

  • Java · Les 60 · Gemiddeld · Versie: 2

Bronnen