JavaScript метод toExponential()

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

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

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

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

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

JavaScript синтаксис:

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

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

Версия JavaScript

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

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

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

Параметр

Описание

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