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

CKTIS / Java

RoundingMode — règles d’arrondi des nombres décimaux

java.math.RoundingMode définit une règle d’arrondi utilisée notamment par BigDecimal. HALF_UP choisit la valeur la plus proche et, en cas d’égalité, arrondit en s’éloignant de zéro, y compris pour les nombres négatifs.

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

Syntaxe

value.setScale(newScale, RoundingMode.HALF_UP)

java.math.RoundingMode est un type énuméré qui définit une règle d’arrondi. RoundingMode.HALF_UP choisit la valeur la plus proche ; en cas d’égalité, l’arrondi se fait en s’éloignant de zéro. À l’échelle 2, 2.345 devient 2.35 et -2.345 devient -2.35.

UP arrondit en s’éloignant de zéro, DOWN vers zéro, CEILING vers l’infini positif et FLOOR vers l’infini négatif. HALF_DOWN et HALF_EVEN choisissent la valeur la plus proche ; en cas d’égalité, le premier arrondit vers zéro, tandis que le second choisit un résultat dont le dernier chiffre conservé est pair. UNNECESSARY exige un résultat exact ; si un arrondi est nécessaire, une ArithmeticException est déclenchée.

Pour BigDecimal, setScale(2, RoundingMode.HALF_UP) définit deux chiffres après la virgule, et non deux chiffres significatifs. BigDecimal est immuable : utilisez la valeur renvoyée. Un constructeur prenant une chaîne, comme new BigDecimal("2.345"), préserve la valeur décimale exacte ; un constructeur prenant un double peut introduire les effets de la représentation binaire du nombre.

L’exemple compare HALF_UP à HALF_EVEN et montre que la valeur d’origine reste inchangée. La documentation porte sur Java SE 21 ; l’environnement d’exécution en production n’est pas attesté.

Exemples

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

public class Main {
    public static void main(String[] args) {
        BigDecimal positive = new BigDecimal("2.345");
        BigDecimal negative = new BigDecimal("-2.345");

        System.out.println(positive.setScale(2, RoundingMode.HALF_UP));
        System.out.println(negative.setScale(2, RoundingMode.HALF_UP));
        System.out.println(positive.setScale(2, RoundingMode.HALF_EVEN));
        System.out.println(positive);
    }
}

Résultat

2.35
-2.35
2.34
2.345

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