The toExponential()
method returns a string representing the Number object in exponential notation.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
numObj.toExponential([fractionDigits])
Parameters
fractionDigits
- Optional. An integer specifying the number of digits after the decimal point. Defaults to as many digits as necessary to specify the number.
Return value
A string representing the given Number
object in exponential notation with one digit before the decimal point, rounded to fractionDigits
digits after the decimal point.
Exceptions
RangeError
- If
fractionDigits
is too small or too large. Values between 0 and 20, inclusive, will not cause aRangeError
. Implementations are allowed to support larger and smaller values as well. TypeError
- If this method is invoked on an object that is not a
Number
.
Description
If the fractionDigits
argument is omitted, the number of digits after the decimal point defaults to the number of digits necessary to represent the value uniquely.
If you use the toExponential()
method for a numeric literal and the numeric literal has no exponent and no decimal point, leave whitespace(s) before the dot that precedes the method call to prevent the dot from being interpreted as a decimal point.
If a number has more digits than requested by the fractionDigits
parameter, the number is rounded to the nearest number represented by fractionDigits
digits. See the discussion of rounding in the description of the toFixed()
method, which also applies to toExponential()
.
Examples
Using toExponential
var numObj = 77.1234; console.log(numObj.toExponential()); // logs 7.71234e+1 console.log(numObj.toExponential(4)); // logs 7.7123e+1 console.log(numObj.toExponential(2)); // logs 7.71e+1 console.log(77.1234.toExponential()); // logs 7.71234e+1 console.log(77 .toExponential()); // logs 7.7e+1
Specifications
Specification |
---|
ECMAScript (ECMA-262) The definition of 'Number.prototype.toExponential' in that specification. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
toExponential | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 5.5 | Opera Full support 7 | Safari Full support 2 | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support 10.1 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 | nodejs Full support 0.1.100 |
Legend
- Full support
- Full support