CKTIS / Java
BigDecimal : calcul décimal exact, échelle et comparaison
Lire des décimaux sans passer par `double`, calculer exactement, choisir une échelle et une règle d’arrondi, puis comparer les valeurs indépendamment de leur échelle.
Version : Java SE 21
Syntaxe
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.RoundingModeDans Java SE 21, le constructeur BigDecimal(String) du paquet java.math lit exactement une valeur décimale sans passer par double. Utilisez un point décimal, pas une virgule ; les espaces et les séparateurs de groupes de chiffres sont refusés. Un texte invalide déclenche NumberFormatException. Sans exposant, l’échelle compte les chiffres après le point, y compris les zéros finaux ; un exposant explicite est soustrait de cette échelle.
Les méthodes à un argument BigDecimal.add et BigDecimal.multiply renvoient la somme et le produit exacts. La somme prend la plus grande des échelles des opérandes ; l’échelle préférée du produit est la somme de leurs échelles. Dans le JDK 21, si cette somme est hors de l’intervalle du type int, la multiplication peut déclencher ArithmeticException. Si l’objet sur lequel la méthode est appelée (this) vaut zéro, la méthode renvoie plutôt zéro avec une échelle ramenée à la borne la plus proche de cet intervalle. Les surcharges avec MathContext peuvent arrondir selon ce contexte. Les objets BigDecimal sont immuables : conservez le résultat renvoyé, car les opérandes ne changent pas.
BigDecimal.setScale fixe l’échelle du résultat. setScale(int) déclenche ArithmeticException si un arrondi est nécessaire ; setScale(int, RoundingMode) permet de choisir une règle. HALF_UP arrondit à la valeur la plus proche et, à mi-chemin, s’éloigne de zéro. UNNECESSARY déclenche ArithmeticException si un arrondi est nécessaire. La surcharge setScale(int, int) est obsolète.
BigDecimal.stripTrailingZeros retire les zéros finaux de la représentation sans modifier la valeur. L’échelle peut devenir négative, comme pour 600.0 après suppression (échelle -2) ; pour zéro, la méthode renvoie BigDecimal.ZERO. Un dépassement des limites de l’échelle déclenche ArithmeticException. BigDecimal.toPlainString renvoie du texte sans exposant ni formatage régional. Pour obtenir un nombre fixe de décimales, fixez d’abord l’échelle. Relire ce texte préserve la valeur, mais pas forcément l’échelle.
BigDecimal.compareTo compare les valeurs sans tenir compte de l’échelle : il renvoie -1, 0 ou 1 selon que le premier opérande est inférieur, égal ou supérieur au second. Pour tester l’égalité numérique, utilisez a.compareTo(b) == 0 ; equals exige la même valeur et la même échelle, et renvoie donc false pour 2.0 et 2.00.
Exemples
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));
}
}Résultat
exact: 7.505 rounded: 7.51 stripped scale: -2 plain: 600 compareTo: 0 equals: false
Le résultat exact `7.505` est arrondi à `7.51`. Après suppression des zéros de `600.0`, l’échelle vaut `-2`, mais le texte sans exposant est `600`. La comparaison avec `600.00` donne `0`, tandis que `equals` renvoie `false`.
Leçons associées
- Java · Leçon 60 · Intermédiaire · Version : 2