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

CKTIS / Java

BigDecimal.setScale — modifier l’échelle et arrondir

Fixez l’échelle d’un `BigDecimal` en conservant sa valeur ou en choisissant explicitement un mode d’arrondi. L’objet d’origine reste inchangé.

Version : Java SE 21

Syntaxe

public BigDecimal setScale(int newScale)
public BigDecimal setScale(int newScale, RoundingMode roundingMode)
@Deprecated(since = "9")
public BigDecimal setScale(int newScale, int roundingMode)

BigDecimal.setScale est une méthode d’instance de java.math.BigDecimal. Une échelle positive ou nulle indique le nombre de décimales ; une échelle de -1 correspond à des multiples de dix. L’échelle n’est pas la précision (le nombre de chiffres de la valeur non mise à l’échelle). La méthode renvoie un BigDecimal, pas du texte formaté. L’objet d’origine est immuable : utilisez la valeur renvoyée, qui ne nécessite pas forcément la création d’un nouvel objet.

setScale(int) conserve la valeur numérique. En écriture décimale, augmenter l’échelle peut ajouter des zéros finaux ; la diminuer sans changer la valeur ne peut retirer que des zéros. Si un arrondi est nécessaire, la méthode lève une ArithmeticException.

setScale(int, RoundingMode) applique le mode choisi dans java.math.RoundingMode si la réduction de l’échelle impose un arrondi. HALF_UP choisit la valeur la plus proche à l’échelle demandée et, à égale distance, celle qui s’éloigne de zéro : 2.675 devient 2.68 à l’échelle 2. UNNECESSARY exige un résultat exact et entraîne une ArithmeticException si un arrondi est nécessaire.

La surcharge setScale(int, int) est dépréciée depuis Java 9 et lève une IllegalArgumentException si son deuxième argument ne représente pas un mode d’arrondi valide. Dans le nouveau code, utilisez la surcharge avec RoundingMode. Pour saisir exactement une valeur décimale, utilisez new BigDecimal("2.675") plutôt que new BigDecimal(2.675), qui reprend l’approximation binaire du double.

Exemples

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

public class Main {
    public static void main(String[] args) {
        BigDecimal original = new BigDecimal("2.675");
        BigDecimal padded = original.setScale(4);
        System.out.println(padded.toPlainString());
        System.out.println(padded.setScale(3).toPlainString());
        System.out.println(original.setScale(2, RoundingMode.HALF_UP).toPlainString());

        try {
            original.setScale(2);
        } catch (ArithmeticException e) {
            System.out.println("ArithmeticException");
        }

        System.out.println(original.toPlainString());
    }
}

Résultat

2.6750
2.675
2.68
ArithmeticException
2.675

Les deux premières lignes montrent l’ajout puis le retrait d’un zéro final sans changement de valeur. La troisième montre l’arrondi, la quatrième signale l’exception interceptée et la dernière affiche la valeur d’origine inchangée.

Leçons associées

  • Java · Leçon 4 · Débutant · Version : 2
  • Java · Leçon 6 · Débutant · Version : 2
  • Java · Leçon 69 · Débutant · Version : 2

Sources