CKTIS / JavaScript
Math.trunc : partie entière vers zéro
Math.trunc convertit son argument en Number et supprime sa partie fractionnaire, en arrondissant vers zéro.
Version : ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
Math.trunc(x)Math.trunc(x) applique ToNumber et renvoie la partie entière de x fini : 3.9 devient 3 et -3.9 devient -3. Si le Number est déjà entier, il est renvoyé sans changement, y compris pour +0 et -0. Le résultat reste un Number et n’acquiert donc pas une précision arbitraire.
NaN et l’absence d’argument donnent NaN, tandis que Infinity et -Infinity sont renvoyés tels quels. Une chaîne numérique est convertie ; Symbol ou BigInt lève TypeError, et la conversion d’un objet peut exécuter du code utilisateur. Une fraction négative entre -1 et 0 produit -0, détectable avec Object.is ; l’entrée est déjà une valeur binary64 arrondie avant la troncature.
La méthode existe depuis ECMAScript 2015 et n’est pas un constructeur. L’exemple convertit 9876 millisecondes en 9 secondes entières et illustre la conversion ainsi que -0. Ne remplacez pas la troncature d’un nombre par parseInt ni par des opérations binaires qui convertissent sur 32 bits ; pour de grands entiers exacts, utilisez une arithmétique BigInt adaptée plutôt que Math.trunc.
Exemples
const milliseconds = 9876;
console.log(Math.trunc(milliseconds / 1000));
console.log(Math.trunc(3.9), Math.trunc(-3.9));
console.log(Object.is(Math.trunc(-0.25), -0));
console.log(Math.trunc("12.8"));
try { Math.trunc(1n); } catch (error) { console.log(error instanceof TypeError); }Résultat
9 3 -3 true 12 true
Math.trunc → secondes entières, conversion de chaîne, zéro négatif et TypeError pour BigInt