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 toExponential()-Methode 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 Stellen nach dem Dezimalpunkt angibt. Standardmäßig wird so viele Stellen wie nötig verwendet, um die Zahl darzustellen.

Rückgabewert

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

Ausnahmen

RangeError

Wirft einen Fehler, wenn fractionDigits nicht zwischen 0 und 100 (einschließlich) liegt.

TypeError

Wirft einen Fehler, wenn diese Methode auf ein Objekt angewendet wird, das kein Number ist.

Beschreibung

Falls das fractionDigits-Argument weggelassen wird, entspricht die Anzahl der Stellen nach dem Dezimalpunkt der Anzahl, die erforderlich ist, um den Wert eindeutig darzustellen.

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

Falls eine Zahl mehr Stellen hat, als durch den fractionDigits-Parameter angegeben, wird die Zahl auf die nächste durch fractionDigits Stellen repräsentierte 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® 2025 Language Specification
# sec-number.prototype.toexponential

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch