JavaScript метод toExponential()

JavaScript Number

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

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


Обращаю Ваше внимание, что метод toExponential(), если необходимо округляет, или дополняет нулями дробную часть для достижения необходимой длины. Если число представлено в экспоненциальной форме записи числа, то будет вызван метод Number.prototype.toString(), который вернет строку в экспоненциальной форме записи числа.


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

МетодChrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
Edge
toExponential()ДаДаДаДаДаДа

JavaScript синтаксис:

// количество десятичных знаков по умолчанию равно количеству цифр необходимых для уникального представления значения в экспоненциальной форме записи числа
num.toExponential();

// количество десятичных знаков после запятой соответствует значению, указанному в параметре метода
num.toExponential( fractionDigits );

Версия JavaScript

3 (первоначальная реализация в версии 1.5)

Значения параметров

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

Исключения

Тип исключенияОписание
RangeErrorВозникает в том случае, если параметр fractionDigits не находится в диапазоне от 0 до 100 (включительно). Диапазон может отличаться в зависимости от конкретной реализации.
TypeErrorВозникает в том случае, если метод вызывается для значения, которое не является числовым объектом.

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

var num = 12345.6789; // инициализируем числовую переменную

num.toExponential(); // возвращаемое значение "1.23456789e+4"
num.toExponential( 3 ); // возвращаемое значение "1.235e+4"
num.toExponential( 2 ); // возвращаемое значение "1.23e+4"
num.toExponential( 1.1 ); // возвращаемое значение "1.2e+4"
num.toExponential( 1.9 ); // возвращаемое значение "1.2e+4"
num.toExponential( 10 ); // возвращаемое значение "1.2345678900e+4"
num.toExponential( true + true ); // возвращаемое значение "1.23e+4"
num.toExponential( -1 ); // RangeError
num.toExponential( 101 ); // RangeError

var str = "12345.6789"; // инициализируем строковую переменную
str.toExponential(); // TypeError

123.45.toExponential( 1 ); // возвращаемое значение "1.2e+2"
123.toExponential( 2 );  // SyntaxError
(123).toExponential( 2 ); // возвращаемое значение "1.23e+2"
123..toExponential( 2 ); // возвращаемое значение "1.23e+2"
123 .toExponential( 2 ); // возвращаемое значение "1.23e+2"

(1.11e+20).toExponential( 2 ); // возвращаемое значение "1.11e+20"
JavaScript Number