Number.prototype.toExponential()

Сводка

Метод toExponential() возвращает строку, представляющую объект Number в экспоненциальной записи.

Синтаксис

numObj.toExponential([fractionDigits])

Параметры

fractionDigits
Необязательный параметр. Целое число, определяющее количество цифр после десятичной запятой. По умолчанию используется столько цифр, сколько необходимо для указания числа.

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

Строка, представляющая объект Number в экспоненциальной записи с одной цифрой перед десятичной запятой, округлённое до fractionDigits цифр после десятичной запятой. Если аргумент fractionDigits опущен, количество цифр после десятичной запятой по умолчанию устанавливается в количество цифр, необходимых для однозначного представления значения.

Если вы используете метод toExponential() с числовыми литералами и числовой литерал не имеет экспоненты и десятичной запятой, оставьте пробел перед точкой, предшествующей вызову метода для предотвращения интерпретации этой точки как десятичной запятой.

Если число имеет больше цифр, чем запрошено параметром fractionDigits, оно будет округлено к ближайшему числу, представляемому fractionDigits цифрами. Смотрите обсуждение округления в описании метода toFixed(), которое так же применяется и к методу toExponential().

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

RangeError
Если параметр fractionDigits слишком маленький или слишком большой. Значения между 0 и 20 включительно не будут порождать исключение RangeError. Также реализации могут поддерживать большие и меньшие значения.
TypeError
Если этот метод вызывается на объекте, не являющимся объектом Number.

Примеры

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

var numObj = 77.1234;


console.log(numObj.toExponential());  // выведет 7.71234e+1
console.log(numObj.toExponential(4)); // выведет 7.7123e+1
console.log(numObj.toExponential(2)); // выведет 7.71e+1
console.log(77.1234.toExponential()); // выведет 7.71234e+1
console.log(77 .toExponential());     // выведет 7.7e+1

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

Спецификация Статус Комментарии
ECMAScript 3-е издание. Стандарт Изначальное определение. Реализована в JavaScript 1.5.
ECMAScript 5.1 (ECMA-262)
Определение 'Number.prototype.toExponential' в этой спецификации.
Стандарт
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'Number.prototype.toExponential' в этой спецификации.
Стандарт

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

BCD tables only load in the browser

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