CKTIS / JavaScript
Math.floor: zaokrąglenie w dół
Math.floor konwertuje argument na Number i zwraca największą całkowitą wartość numeryczną nie większą od wejścia.
Wersja: ECMAScript 1 onward; example target: Node.js 24.22.2
Składnia
Math.floor(x)Math.floor(x) stosuje ToNumber i zaokrągla w kierunku -Infinity. Dlatego floor(7.9) to 7, a floor(-7.1) to -8. Liczba całkowita i ±Infinity pozostają bez zmian, NaN daje NaN. floor(-0) zachowuje -0, natomiast każda skończona liczba między -1 a 0 daje -1.
Łańcuch liczbowy jest konwertowany, null staje się 0, a brak argumentu daje NaN. Symbol i BigInt powodują TypeError; obiekt może uruchomić valueOf lub toString. Wynik pozostaje Number i nie odzyska cyfr utraconych wcześniej przez precyzję IEEE 754.
Funkcja nie jest konstruktorem i jest standardowa od ECMAScript 1. Przydaje się do indeksów przedziałów, np. Math.floor(timestamp / windowMs). Dla ujemnych danych nie zastępuj jej bezmyślnie Math.trunc: trunc zaokrągla do zera, więc daje inny przedział. Przed dzieleniem sprawdź dodatni, niezerowy rozmiar przedziału.
Przykłady
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); }Wynik
1,2,-1 7 -8 true -1 3 0 true -Infinity true