CKTIS / JavaScript
Math.trunc: część całkowita w kierunku zera
Math.trunc konwertuje argument do Number i usuwa jego część ułamkową, zaokrąglając w kierunku zera.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
Math.trunc(x)Math.trunc(x) stosuje ToNumber i zwraca całkowitą część skończonego x: 3.9 daje 3, a -3.9 daje -3. Jeśli Number jest już całkowity, funkcja zwraca go bez zmiany, włącznie z zachowaniem +0 i -0. Wynik nadal ma typ Number, więc nie zyskuje dowolnej precyzji.
NaN i brak argumentu dają NaN, natomiast Infinity i -Infinity są zwracane bez zmiany. Łańcuch liczbowy jest konwertowany; Symbol lub BigInt powoduje TypeError, a konwersja obiektu może uruchomić kod użytkownika. Ujemny ułamek między -1 a 0 daje -0, co można wykryć przez Object.is; wejście jest już zaokrągloną wartością binary64 przed obcięciem.
Metoda istnieje od ECMAScript 2015 i nie jest konstruktorem. Przykład przelicza 9876 milisekund na 9 pełnych sekund i pokazuje konwersję oraz -0. Nie zastępuj jej przez parseInt do obcinania liczb ani przez operacje bitowe, które konwertują do 32 bitów; dla dokładnych dużych liczb całkowitych użyj odpowiedniej arytmetyki BigInt zamiast Math.trunc.
Przykłady
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); }Wynik
9 3 -3 true 12 true
Math.trunc → pełne sekundy, konwersja łańcucha, ujemne zero i TypeError dla BigInt