CKTIS / Java
Division BigDecimal avec échelle et mode d’arrondi explicites
Cette surcharge de `divide` permet de fixer l’échelle du quotient et de choisir la règle d’arrondi. Le résultat a l’échelle demandée même si la division est exacte.
Version : Java SE 21
Syntaxe
public BigDecimal divide(BigDecimal divisor, int scale, RoundingMode roundingMode)
BigDecimal quotient = dividend.divide(divisor, scale, roundingMode);dividend.divide(divisor, scale, roundingMode) divise dividend par divisor. Les deux opérandes sont de type java.math.BigDecimal et restent inchangés. L’argument scale, de type int, fixe l’échelle du résultat. L’argument de type java.math.RoundingMode indique comment arrondir si nécessaire.
Une échelle de 2 donne deux chiffres après le séparateur décimal, y compris les zéros finaux. Une échelle de 0 donne un résultat entier et une échelle de -2 un multiple de 100. L’échelle n’est pas le nombre de chiffres significatifs. HALF_UP choisit la valeur la plus proche à l’échelle demandée et, à égale distance, celle qui est la plus éloignée de zéro.
Une division par zéro lève une ArithmeticException. Il en va de même avec UNNECESSARY si le quotient exact ne peut pas être représenté à l’échelle demandée sans arrondi. La valeur exacte 0.5 peut s’écrire 0.50 à l’échelle 2 sans changer de valeur.
divide(divisor, roundingMode) utilise l’échelle du dividende. divide(divisor) exige un résultat exact et lève une exception si le développement décimal est infini. divide(divisor, mathContext) utilise la précision et le mode d’arrondi du contexte plutôt que de recevoir une échelle cible. L’ancienne surcharge qui reçoit le mode d’arrondi sous forme d’int est obsolète ; utilise plutôt RoundingMode.
Exemples
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal one = BigDecimal.ONE;
BigDecimal rounded = one.divide(BigDecimal.valueOf(8), 2, RoundingMode.HALF_UP);
BigDecimal exact = one.divide(BigDecimal.valueOf(2), 2, RoundingMode.HALF_UP);
System.out.println(rounded.toPlainString());
System.out.println(exact.toPlainString());
}
}Résultat
0.13 0.50
Le quotient exact de `1 / 8` est `0.125` ; `HALF_UP` donne donc `0.13`. Le quotient de `1 / 2` ne nécessite aucun arrondi : `toPlainString()` affiche `0.50`, en conservant le zéro final imposé par l’échelle `2`.
Leçons associées
- Java · Leçon 69 · Débutant · Version : 2