JavaScript метод Number.prototype.toExponential()

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

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

Проверьте поведение в редактируемом примере.

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

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.Number.toExponential
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
toExponential✓1✓12✓1✓7✓2✓18✓4✓10.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

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

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

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

ECMAScript: Number.prototype.toExponential()

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

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

Исключения

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

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

Возвращает строку с одной цифрой до точки и показателем степени e. Аргумент задаёт число цифр после точки, а не общее число значащих цифр. Для NaN и бесконечностей возвращается соответствующая строка; проверка диапазона fractionDigits для этих значений не выполняется.

Примеры, попробуйте сами

Как задать точность экспоненциальной записи

Измените число и fractionDigits; сравните мантиссу, показатель степени и ошибки диапазона.

index.html
HTML
<p>Результат выполнения выводится в консоль.</p>
main.js
JavaScript
var num = 12345.6789 // инициализируем числовую переменную

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

var str = '12345.6789' // инициализируем строковую переменную
try {
    console.log(str.toExponential())
} catch (error) {
    console.log(error.name)
} // TypeError

try {
    console.log((123.45).toExponential(1))
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "1.2e+2"
// 123.toExponential(2) — SyntaxError: точка читается как дробная часть; пишите (123).toExponential(2) или 123..toExponential(2)
try {
    console.log((123).toExponential(2))
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "1.23e+2"

try {
    console.log((1.11e20).toExponential(2))
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "1.11e+20"

console.log('Длина строки при 100 знаках:', (1).toExponential(100).length)
console.log('Бесконечность:', Infinity.toExponential(101))