WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen