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

CKTIS / JavaScript

Math.floor : arrondi vers le bas

Math.floor convertit son argument en Number et renvoie la plus grande valeur numérique entière qui n’est pas supérieure à l’entrée.

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

Syntaxe

Math.floor(x)

Math.floor(x) applique ToNumber et arrondit vers -Infinity. floor(7.9) vaut 7, floor(-7.1) vaut -8. Un entier et ±Infinity restent, NaN donne NaN. floor(-0) conserve -0, tandis que tout nombre fini entre -1 et 0 donne -1.

Une chaîne numérique est convertie, null devient 0 et l’absence d’argument donne NaN. Symbol ou BigInt lève TypeError ; un objet peut exécuter valueOf ou toString. Le Number ne restaure pas les chiffres perdus par IEEE 754.

Pas un constructeur, standard depuis ECMAScript 1. Utile pour Math.floor(timestamp / windowMs). Avec des données négatives, ne remplacez pas aveuglément par Math.trunc : il arrondit vers zéro et choisit un autre intervalle. Vérifiez une taille positive non nulle.

Exemples

const windowMs = 1000;
const timestamps = [1999, 2000, -1];
console.log(timestamps.map((value) => Math.floor(value / windowMs)).join(","));
console.log(Math.floor(7.9), Math.floor(-7.1));
console.log(Object.is(Math.floor(-0), -0), Math.floor(-0.25));
console.log(Math.floor("3.9"), Math.floor(null));
console.log(Number.isNaN(Math.floor()), Math.floor(-Infinity));
try { Math.floor(1n); } catch (error) { console.log(error instanceof TypeError); }

Résultat

1,2,-1
7 -8
true -1
3 0
true -Infinity
true

Sources