Math.trunc()

Определение и применение

Math.trunc() отбрасывает дробную часть числа, двигаясь к нулю. Например, из 7.9 получается 7, а из −7.9 — −7. Это удобно, когда нужна целая часть измерения без округления к ближайшему значению.

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.Math.trunc
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
trunc✓38✓12✓25✓25✓8✓38✓25✓25✓8✓3.0✓38✓8

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Синтаксис

JavaScript
Math.trunc(value);

value — число для вычисления. Метод вызывается у встроенного объекта Math; создавать экземпляр не нужно. Возвращается новое значение number, исходная переменная не изменяется.

Особенности результата

Для положительных чисел результат совпадает с Math.floor(), для отрицательных — с Math.ceil(). Math.round() решает другую задачу: выбирает ближайшее целое.

В диапазоне от -1 до 0 результатом может быть -0. Знак проверяют через Object.is(). NaN, бесконечности и оба нуля сохраняются. Побитовые сокращения вроде x | 0 не являются общей заменой: они ограничивают число 32 битами.

Преобразование аргумента

Аргумент преобразуется в число: числовая строка подходит, null становится нулём, а undefined или нечисловая строка дают NaN. Преобразование не проверяет, допустимы ли такие данные по условию вашей задачи. Подробнее — преобразование типов.

Исключения

Исключения Math.trunc()
Тип исключения Условие
TypeError Передан BigInt или Symbol. Ошибка пользовательского преобразования объекта в число также не подавляется.

Спецификация

ECMAScript: Math.trunc.

Примеры, попробуйте сами

Целые минуты и отрицательная поправка

Измените seconds и correction. У отрицательного числа trunc и floor дают разные результаты.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Целые минуты и отрицательная поправка</title>
  </head>
  <body>
    <p>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
const seconds = 185
const correction = -2.8
console.log(Math.trunc(seconds / 60))
console.log(Math.trunc(correction), Math.floor(correction), Math.round(correction))
console.log(Object.is(Math.trunc(-0.4), -0))
console.log(Math.trunc('8.9'), Math.trunc(Infinity))