Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła