Number.prototype.toFixed()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Сводка

Метод toFixed() форматирует число, используя запись с фиксированной запятой.

Синтаксис

numObj.toFixed([digits])

Параметры

digits

Необязательный параметр. Количество цифр после десятичной запятой; может быть значением между 0 и 20 включительно, хотя реализации могут поддерживать и больший диапазон значений. Если аргумент опущен, он считается равным 0.

Возвращаемое значение

Строка, представляющая numObj, не использующая экспоненциальную запись и содержащая ровно digits цифр после десятичной запятой. Число округляется при необходимости, а дробная часть дополняется нулями таким образом, чтобы иметь указанную длину. Если numObj больше или равно 1e+21, этот метод просто вызывает метод Number.prototype.toString() и возвращает строку в экспоненциальной записи.

Выбрасываемые исключения

RangeError

Если параметр digits слишком маленький или слишком большой. Значения между 0 и 20 включительно не будут порождать исключение RangeError. Также реализации могут поддерживать большие и меньшие значения.

TypeError

Если этот метод вызывается на объекте, не являющимся объектом Number.

Примеры

Пример: использование toFixed

js
var numObj = 12345.6789;

numObj.toFixed(); // Вернёт '12346': обратите внимание на округление, дробной части нет
numObj.toFixed(1); // Вернёт '12345.7': обратите внимание на округление
numObj.toFixed(6); // Вернёт '12345.678900': обратите внимание на дополнение нулями
(1.23e20).toFixed(2); // Вернёт '123000000000000000000.00'
(1.23e-10).toFixed(2); // Вернёт '0.00'
(2.34).toFixed(1); // Вернёт '2.3'
-(2.34).toFixed(1); // Вернёт -2.3 (в соответствии с приоритетом операций,
// отрицательные числовые литералы не возвращают строку...)
(-2.34).toFixed(1); // Вернёт '-2.3' (...до тех пор, пока вы не заключите их в круглые скобки)

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

Specification
ECMAScript Language Specification
# sec-number.prototype.tofixed

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также