WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number.prototype.toExponential: Exponentialschreibweise

toExponential liefert Exponentialtext mit einer Ziffer vor dem Dezimalpunkt und der verlangten Zahl danach.

Version: ECMAScript 3 onward; example target: Node.js 24.22.2

Syntax

number.toExponential(fractionDigits)

number.toExponential(fractionDigits) formatiert eine Number als Dezimaltext mit kleinem e, explizitem Exponentenzeichen und einer Ziffer vor dem Dezimalpunkt. Ist fractionDigits undefined, wird die kürzeste Ziffernfolge gewählt, die den Number-Wert eindeutig bestimmt. Mit Argument enthält das Ergebnis genau so viele Nachkommastellen.

Das Argument durchläuft ToIntegerOrInfinity: Bruchteile werden gegen null abgeschnitten und NaN wird 0. Für einen endlichen Empfänger gilt 0..100; Werte außerhalb und ±Infinity lösen RangeError aus. Das Argument wird jedoch zuerst konvertiert, danach liefert ein nicht endlicher Empfänger vor der Bereichsprüfung normalen Text. Daher ergibt Infinity.toExponential(101) "Infinity"; ein Argumentobjekt kann bei der Konvertierung trotzdem werfen.

Die Methode existiert seit ECMAScript 3, ist nicht generisch und wirft bei einem anderen Empfänger als Number oder Number-Objekt TypeError. Sie rundet auf das nächste mathematische Ergebnis und wählt beim Gleichstand nach Trennung des Zeichens den größeren Betrag; die Binärdarstellung kann überraschen. Negativ null wird ohne Minus formatiert.

Beispiele

console.log((1234.5).toExponential(2), (0.00125).toExponential(2));
console.log((7).toExponential(), (-0).toExponential(1));
console.log(Infinity.toExponential(101));
try { console.log((1).toExponential(101)); } catch (error) { console.log(error.name); }
try { Number.prototype.toExponential.call("1", 2); } catch (error) { console.log(error.name); }

Ergebnis

1.23e+3 1.25e-3
7e+0 0.0e+0
Infinity
RangeError
TypeError

Das Beispiel zeigt feste Stellen, fehlendes Argument, -0 und die Reihenfolge von Infinity und RangeError.

Quellen