Math.round()

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

Метод Math.round() возвращает ближайшее целое число. Если исходное число находится ровно между двумя целыми, выбирается большее из них, в направлении положительной бесконечности. Метод подходит, например, для округления вычисленной скидки до целого числа копеек.

В уроке «Арифметические операторы и присваивание» округление применяется к цене и количеству товаров.

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

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

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

Показать браузеры
Совместимостьjavascript.builtins.Math.round
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
round✓1✓12✓1✓3✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1

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

Синтаксис и параметр

JavaScript
Math.round(value);

value — число или значение, преобразуемое в число. Метод вызывают у объекта Math, а не у самого значения. Он возвращает новое значение типа number и не меняет переменную аргумента.

Половины и отрицательные числа

Math.round(2.5) даёт 3, а Math.round(-2.5) даёт -2. Правило «половину от нуля» здесь не действует. Значения от -0.5 включительно до нуля дают отрицательный ноль. Он сравнивается с обычным нулём как равный, но Object.is(result, -0) позволяет увидеть знак. Проверьте границы в примере округления.

Math.floor() всегда округляет вниз, а Math.ceil() — вверх. Например, нужно упаковать 21 товар в коробки по 10 товаров. Две коробки вместят только 20 товаров, поэтому для оставшегося товара нужна третья. Расчёт Math.ceil(21 / 10) даст нужные 3 коробки, а Math.round(21 / 10) — только 2.

Преобразования и особые значения

Числовая строка преобразуется в число. Пустая строка и null становятся нулём. Непригодная строка, undefined и вызов без аргумента дают NaN. Значения NaN, Infinity, -Infinity и оба нуля сохраняются. Аргументы типа BigInt и Symbol вызывают TypeError.

Округление суммы

У Math.round() нет параметра количества знаков после запятой. В примере скидки цена хранится целым числом копеек, скидка округляется один раз, затем вычитается. toFixed() в конце используется для вывода и возвращает строку.

Умножение дроби на 100, округление и деление обратно не устраняют погрешность двоичного хранения: Math.round(1.005 * 100) / 100 даёт 1. Правило округления и момент его применения должны соответствовать задаче. Для больших сумм учитывайте границу точных целых чисел, а для точной десятичной арифметики выбирайте подходящее представление данных.

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

ECMAScript: Math.round.

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

Граница половины и знак нуля

Измените 2.5 и -2.5 на 2.49 и -2.51. Сравните направления округления. Последняя строка отдельно проверяет отрицательный ноль.

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
console.log(Math.round(2.5), Math.round(-2.5));
console.log(Math.round("2.6"), Math.round(null));
console.log(Math.round("цена"), Math.round(Infinity));
console.log(Object.is(Math.round(-0.5), -0));

Скидка в целых копейках

Цена равна 1999 копейкам, скидка — 15%. Получатся скидка 300 копеек, остаток 1699 копеек и строка 16.99. Измените процент на 10: остаток станет 1799.

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 priceKopecks = 1999;
const percent = 15;
const discountKopecks = Math.round(priceKopecks * percent / 100);
const totalKopecks = priceKopecks - discountKopecks;
console.log(discountKopecks, totalKopecks);
console.log((totalKopecks / 100).toFixed(2));
console.log(Math.round(1.005 * 100) / 100);