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
- java.math (Java SE 21 & JDK 21)
- BigDecimal (Java SE 21 & JDK 21)
- RoundingMode (Java SE 21 & JDK 21)
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html
- Official reference — docs.oracle.com: math / BigDecimal.html