Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

BigDecimal — arithmétique décimale et arrondi

java.math.BigDecimal gère des nombres décimaux de précision arbitraire, utiles notamment pour les calculs monétaires. Découvrez la création de valeurs, les opérations arithmétiques, l’échelle, la comparaison et l’arrondi explicite.

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

Syntaxe

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 est un nombre décimal immuable de précision arbitraire. BigDecimal(String) construit une valeur exacte à partir d’un texte ; BigDecimal.valueOf(long) en construit une à partir d’un entier. BigDecimal.valueOf(double) utilise la représentation textuelle du double, mais ne peut pas corriger les erreurs de calcul antérieures. Évitez new BigDecimal(0.1) si vous voulez représenter exactement 0.1.

BigDecimal.add, BigDecimal.subtract et BigDecimal.multiply effectuent respectivement l’addition, la soustraction et la multiplication ; conservez la valeur renvoyée. BigDecimal.ZERO représente zéro avec une échelle de 0. BigDecimal.compareTo compare les valeurs numériques en ignorant les différences d’échelle ; equals tient compte de l’échelle, donc considère 2.0 et 2.00 comme différents.

BigDecimal.divide sans paramètres d’arrondi exige un développement décimal exact et fini. L’appel BigDecimal.ONE.divide(BigDecimal.valueOf(3)) déclenche une ArithmeticException, car le quotient exact n’a pas de développement décimal fini. En revanche, l’expression Java 1 / 3 effectue une division entière et donne 0. Une division par zéro déclenche également cette exception. Indiquez une échelle et un RoundingMode lorsque l’arrondi est acceptable. HALF_EVEN choisit la valeur la plus proche et, en cas d’égalité, celle dont le dernier chiffre conservé est pair.

BigDecimal.setScale définit l’échelle, et non le nombre de chiffres significatifs ; réduire l’échelle peut nécessiter un arrondi. Pour les échelles non négatives, l’échelle correspond au nombre de décimales. BigDecimal.stripTrailingZeros supprime les zéros finaux sans modifier la valeur et peut produire une échelle négative. BigDecimal.toPlainString affiche le résultat sans exposant ; ce n’est pas un formatage monétaire adapté aux paramètres régionaux.

Exemples

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

Résultat

38.50
12.83
true
12.5

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources