KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

BigDecimal — decimale rekenkunde en afronden

java.math.BigDecimal ondersteunt decimale getallen met willekeurige precisie, bijvoorbeeld voor geldberekeningen. Leer waarden maken, rekenen, de schaal beheren, vergelijken en expliciet afronden.

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

Syntax

new BigDecimal("12.50"); BigDecimal.valueOf(3); a.add(b); a.subtract(b); a.multiply(b); a.divide(b, 2, RoundingMode.HALF_EVEN); a.setScale(2, RoundingMode.HALF_EVEN); a.compareTo(BigDecimal.ZERO); a.stripTrailingZeros().toPlainString();

java.math.BigDecimal is een onveranderlijk decimaal getal met willekeurige precisie. BigDecimal(String) maakt een exacte waarde op basis van tekst; BigDecimal.valueOf(long) maakt een waarde op basis van een geheel getal. BigDecimal.valueOf(double) gebruikt de tekstuele weergave van de double, maar kan eerdere rekenfouten niet herstellen. Vermijd new BigDecimal(0.1) als je precies 0.1 wilt weergeven.

BigDecimal.add, BigDecimal.subtract en BigDecimal.multiply voeren optellingen, aftrekkingen en vermenigvuldigingen uit; gebruik het geretourneerde resultaat verder. BigDecimal.ZERO is nul met schaal 0. BigDecimal.compareTo vergelijkt numerieke waarden en negeert schaalverschillen; equals houdt wel rekening met de schaal en beschouwt 2.0 en 2.00 daarom als ongelijk.

BigDecimal.divide zonder afrondingsparameters vereist een exacte, eindige decimale uitkomst. De aanroep BigDecimal.ONE.divide(BigDecimal.valueOf(3)) veroorzaakt een ArithmeticException, omdat het exacte quotiënt geen eindige decimale weergave heeft. De Java-expressie 1 / 3 daarentegen voert een gehele deling uit en levert 0 op. Delen door nul veroorzaakt deze uitzondering ook. Geef een schaal en een RoundingMode op als afronden aanvaardbaar is. HALF_EVEN kiest de dichtstbijzijnde waarde en kiest bij gelijke afstand de waarde waarvan het laatst behouden cijfer even is.

BigDecimal.setScale stelt de schaal in, niet het aantal significante cijfers; een kleinere schaal kan afronden vereisen. Bij niet-negatieve schalen is de schaal het aantal decimalen. BigDecimal.stripTrailingZeros verwijdert nullen achteraan zonder de waarde te veranderen en kan een negatieve schaal opleveren. BigDecimal.toPlainString geeft het resultaat weer zonder exponent; het is geen locale-afhankelijke valutaopmaak.

Voorbeelden

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

public class Main {
    public static void main(String[] args) {
        BigDecimal price = new BigDecimal("12.50");
        BigDecimal total = price.multiply(BigDecimal.valueOf(3))
                .add(new BigDecimal("2.00"))
                .subtract(new BigDecimal("1.00"))
                .setScale(2, RoundingMode.HALF_EVEN);
        BigDecimal share = total.divide(BigDecimal.valueOf(3), 2,
                RoundingMode.HALF_EVEN);

        System.out.println(total.toPlainString());
        System.out.println(share.toPlainString());
        System.out.println(total.compareTo(BigDecimal.ZERO) > 0);
        System.out.println(new BigDecimal("12.500")
                .stripTrailingZeros().toPlainString());
    }
}

Resultaat

38.50
12.83
true
12.5

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