Number.prototype.toExponential()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Methode toExponential() von Number-Werten gibt einen String zurück, der diese Zahl in exponentieller Notation darstellt.

Probieren Sie es aus

function expo(x, f) {
  return Number.parseFloat(x).toExponential(f);
}

console.log(expo(123456, 2));
// Expected output: "1.23e+5"

console.log(expo("123456"));
// Expected output: "1.23456e+5"

console.log(expo("oink"));
// Expected output: "NaN"

Syntax

js
toExponential()
toExponential(fractionDigits)

Parameter

fractionDigits Optional

Optional. Eine ganze Zahl, die die Anzahl der Nachkommastellen angibt. Standardmäßig entspricht dies der Anzahl der Stellen, die erforderlich sind, um die Zahl anzugeben.

Rückgabewert

Ein String, der das gegebene Number-Objekt in exponentieller Notation mit einer Ziffer vor dem Dezimalpunkt darstellt, gerundet auf fractionDigits Nachkommastellen.

Ausnahmen

RangeError

Wird ausgelöst, wenn fractionDigits nicht zwischen 0 und 100 (einschließlich) liegt.

TypeError

Wird ausgelöst, wenn diese Methode auf einem Objekt aufgerufen wird, das kein Number ist.

Beschreibung

Wird das fractionDigits-Argument weggelassen, entspricht die Anzahl der Nachkommastellen standardmäßig der Anzahl, die erforderlich ist, um den Wert eindeutig darzustellen.

Wenn Sie die toExponential()-Methode für ein numerisches Literal verwenden und das numerische Literal keinen Exponenten und keinen Dezimalpunkt hat, lassen Sie Leerzeichen vor dem Punkt, der dem Methodenaufruf vorausgeht, um zu verhindern, dass der Punkt als Dezimalpunkt interpretiert wird.

Wenn eine Zahl mehr Stellen hat, als durch den fractionDigits-Parameter gefordert, wird die Zahl auf die nächste, durch fractionDigits-Stellen vertretene Zahl gerundet. Siehe die Diskussion über das Runden in der Beschreibung der toFixed()-Methode, die auch für toExponential() gilt.

Beispiele

Verwendung von toExponential

js
const 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

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-number.prototype.toexponential

Browser-Kompatibilität

Siehe auch