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
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