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

CKTIS / JavaScript

Math.round : entier le plus proche

Math.round convertit son argument en Number et renvoie le Number entier le plus proche, les égalités allant vers +Infinity.

Version : ECMAScript 1 onward; example target: Node.js 24.22.2

Syntaxe

Math.round(x)

Math.round(x) applique ToNumber. Si deux entiers sont équidistants, il choisit celui le plus proche de +Infinity : 2.5 devient 3, mais -2.5 devient -2. Un argument déjà entier, NaN, +Infinity, -Infinity, +0 ou -0 est renvoyé en préservant cette valeur spéciale.

De -0.5 inclus à 0 exclu, le résultat est -0, détectable avec Object.is ou l’inverse. Math.round(x) n’est donc pas toujours équivalent à Math.floor(x + 0.5), qui peut perdre le signe du zéro ; l’addition peut aussi arrondir un très grand x.

Une chaîne numérique est convertie, l’absence d’argument donne NaN, et Symbol ou BigInt lève TypeError. La fonction existe depuis ECMAScript 1 et n’est pas un constructeur. Elle arrondit une valeur, sans formater du texte ; traitez séparément l’affichage décimal et l’arrondi binary64.

Exemples

console.log([2.3, 2.5, -2.5, -2.6].map(Math.round).join(","));
console.log(Object.is(Math.round(-0.5), -0), Object.is(Math.round(-0.1), -0));
console.log(Math.round("4.6"), Math.round(Infinity));
console.log(Number.isNaN(Math.round()), Object.is(Math.round(-0), -0));
try { Math.round(3n); } catch (error) { console.log(error instanceof TypeError); }

Résultat

2,3,-2,-3
true true
5 Infinity
true true
true

Math.round → ties toward +Infinity and preserved -0

Sources