CKTIS / JavaScript
Math.floor: abwärts runden
Math.floor wandelt das Argument in Number um und liefert den größten ganzzahligen numerischen Wert, der nicht größer als die Eingabe ist.
Version: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Math.floor(x)Math.floor(x) wendet ToNumber an und rundet gegen -Infinity. floor(7.9) ist 7, floor(-7.1) ist -8. Ganze Zahlen und ±Infinity bleiben, NaN ergibt NaN. floor(-0) bewahrt -0, jede endliche Zahl zwischen -1 und 0 ergibt -1.
Numerische Zeichenketten werden umgewandelt, null wird 0 und fehlendes Argument NaN. Symbol oder BigInt löst TypeError aus; Objekte können valueOf oder toString ausführen. Das Number-Ergebnis stellt keine durch IEEE 754 verlorenen Ziffern wieder her.
Kein Konstruktor, seit ECMAScript 1 Standard. Nützlich für Math.floor(timestamp / windowMs). Bei negativen Daten nicht blind durch Math.trunc ersetzen: trunc rundet gegen null und wählt ein anderes Intervall. Positive, von null verschiedene Intervallgröße prüfen.
Beispiele
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); }Ergebnis
1,2,-1 7 -8 true -1 3 0 true -Infinity true