Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Math : méthode statique round()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La méthode statique Math.round() retourne la valeur d'un nombre arrondi à l'entier le plus proche.

Exemple interactif

console.log(Math.round(0.9));
// Sortie attendue : 1

console.log(Math.round(5.95), Math.round(5.5), Math.round(5.05));
// Sortie attendue : 6 6 5

console.log(Math.round(-5.05), Math.round(-5.5), Math.round(-5.95));
// Sortie attendue : -5 -5 -6

Syntaxe

js
Math.round(x)

Paramètres

x

Un nombre.

Valeur de retour

La valeur de x arrondie à l'entier le plus proche.

Description

Si la partie fractionnaire de l'argument est supérieure à 0,5, l'argument est arrondi à l'entier dont la valeur absolue est la plus proche. Si elle est inférieure à 0,5, l'argument est arrondi à l'entier dont la valeur absolue est la plus petite. Si la partie fractionnaire est exactement 0,5, l'argument est arrondi à l'entier suivant dans la direction de +∞.

Note : Cela diffère de la fonction round() de nombreux langages, qui arrondissent souvent les demi-incréments loin de zéro, donnant un résultat différent dans le cas des nombres négatifs dont la partie fractionnaire est exactement 0,5.

Math.round(x) n'est pas exactement la même chose que Math.floor(x + 0.5). Lorsque x est -0, ou -0,5 ≤ x < 0, Math.round(x) retourne -0, tandis que Math.floor(x + 0.5) retourne 0. Cependant, en négligeant cette différence et les erreurs de précision potentielles, Math.round(x) et Math.floor(x + 0.5) sont généralement équivalents.

Puisque round() est une méthode statique de Math, vous l'utilisez toujours comme Math.round(), plutôt que comme une méthode d'un objet Math que vous avez créé (Math n'a pas de constructeur).

Exemples

Utiliser Math.round()

js
Math.round(-Infinity); // -Infinity
Math.round(-20.51); // -21
Math.round(-20.5); // -20
Math.round(-0.1); // -0
Math.round(0); // 0
Math.round(20.49); // 20
Math.round(20.5); // 21
Math.round(42); // 42
Math.round(Infinity); // Infinity

Spécifications

Spécification
ECMAScript® 2027 Language Specification
# sec-math.round

Compatibilité des navigateurs

Voir aussi