WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number.prototype.toFixed: feste Dezimalstellen

toFixed liefert Festkommatext mit genau der verlangten Zahl von Ziffern nach dem Dezimalpunkt.

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

Syntax

number.toFixed(fractionDigits)

number.toFixed(fractionDigits) liefert Text mit genau fractionDigits Ziffern nach dem Dezimalpunkt; ohne Argument gilt 0. Das Argument durchläuft ToIntegerOrInfinity: Ein Bruch wird gegen null abgeschnitten, NaN wird 0, und auch -0.5 führt zu null. Der Bereich 0..100 wird vor nicht endlichen Werten geprüft, daher wirft sogar Infinity.toFixed(101) einen RangeError.

Bei gültiger Stellenzahl liefern NaN und ±Infinity "NaN" bzw. den Unendlichkeitstext. Ab einem Betrag von 10**21 verwendet die Methode gewöhnliches ToString und hängt keine festen Dezimalstellen an. Sonst wählt sie das nächste Ergebnis und beim Gleichstand nach Trennung des Zeichens den größeren Betrag. Da Number binär ist, ergibt (2.55).toFixed(1) "2.5"; negativ null verliert sein Zeichen, während ein kleiner negativer Wert gerundet etwa "-0.00" ergeben kann.

Die Methode existiert seit ECMAScript 3, ist nicht generisch und wirft bei einem anderen Empfänger als Number oder Number-Objekt TypeError. Sie liefert Text, keine Zahl, und formatiert nicht lokal. Für Geld beseitigt toFixed binäre Fehler nicht; speichere die kleinste Einheit ganzzahlig oder nutze einen passenden Dezimaltyp.

Beispiele

console.log((12.375).toFixed(2), (2.55).toFixed(1));
console.log((-0).toFixed(2), (-0.0001).toFixed(2));
console.log((1e21).toFixed(2), Infinity.toFixed(2));
try { console.log(Infinity.toFixed(101)); } catch (error) { console.log(error.name); }
try { Number.prototype.toFixed.call("1", 2); } catch (error) { console.log(error.name); }

Ergebnis

12.38 2.5
0.00 -0.00
1e+21 Infinity
RangeError
TypeError

Das Beispiel zeigt Rundung, Binärüberraschung, -0, die 10**21-Grenze und RangeError bei Infinity.

Quellen