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.