Number.prototype.toFixed()

Die toFixed() Methode formatiert eine Zahl in Festkommadarstellung.

Syntax

numObj.toFixed([digits])

Parameter

digits
Optional: Die Anzahl der Stellen, die nach dem Komma angezeigt werden sollen. Das ist ein Wert zwischen 0 und 20 (inklusiv), jedoch gibt es Implementierungen die optional einen größeren Bereich zulassen. Wenn das Argument nicht angegeben wird, wird der Parameter mit dem Standardwert 0 gesetzt.

Rückgabewert

Eine String-Repräsentation der gegebenen Zahl in Festkommadarstellung.

Ausnahmen

RangeError
Tritt auf, wenn digits zu klein oder groß ist. Werte  digits zwischen 0 und 20 (inklusiv) ist, wird es nicht zu einem RangeError führen. Manche Implementierungen erlauben es auch kleinere oder größere Wert zu benutzen.
TypeError
Wenn die Methode auf einem Objekt, welches nicht vom Typ Number ist, aufgerufen wird.

Beschreibung

toFixed() gibt eine String-Repräsentation von numObj zurück, die keine Exponentialdarstellung benutzt und genau digits viele Nachkommastellen beseitzt. Wenn es nötig ist, wird eine Zahl gerundet oder fehlende Dezimalstellen werden mit Nullen aufgefüllt, um die gewünschten Nachkommastellen zu erreichen. Wenn numObj größer als 1021 ist, ruft diese Methode Number.prototype.toString() auf und gibt den string in Exponentialdarstellung zurück.

JavaScript Numbers können nicht alle Zahlen präzise darstellen, was zu unerwarteten Ergebnissen führen kann, wie z. B.  0.1 + 0.2 === 0.3 false ergibt.

Beispiele

Einsatz von toFixed

var numObj = 12345.6789;

numObj.toFixed();       // Rückgabe: '12346': Gerundet, keine Nachkommastellen
numObj.toFixed(1);      // Rückgabe: '12345.7': Gerundet
numObj.toFixed(6);      // Rückgabe: '12345.678900': Nullen hinzugefügt
(1.23e+20).toFixed(2);  // Rückgabe: '123000000000000000000.00'
(1.23e-10).toFixed(2);  // Rückgabe: '0.00'
2.34.toFixed(1);        // Rückgabe: '2.3'
2.35.toFixed(1);        // Rückgabe: '2.4'. Aufgerundet.
2.55.toFixed(1);        // Rückgabe: '2.5'. Abgerundet - siehe die oben stehende Warnung
-2.34.toFixed(1);       // Rückgabe: -2.3 (Negative Nummernliterale geben kein String zurück ...)
(-2.34).toFixed(1);     // Rückgabe: '-2.3' (... außer es werden explizit Klammern verwendet.)

Spezifikationen

Spezifikation Status Kommentar
ECMAScript 3rd Edition (ECMA-262) Standard Initiale Definition. Implementiert in JavaScript 1.5.
ECMAScript 5.1 (ECMA-262)
Die Definition von 'Number.prototype.toFixed' in dieser Spezifikation.		 Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Number.prototype.toFixed' in dieser Spezifikation.		 Standard  
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Number.prototype.toFixed' in dieser Spezifikation.		 Entwurf  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
toFixedChrome Vollständige Unterstützung 1Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 1IE Vollständige Unterstützung 5.5Opera Vollständige Unterstützung JaSafari Vollständige Unterstützung 2WebView Android Vollständige Unterstützung 1Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung 1Samsung Internet Android Vollständige Unterstützung 1.0nodejs Vollständige Unterstützung Ja

Legende

Vollständige Unterstützung  
Vollständige Unterstützung

Siehe auch

Verwandte Themen
  1. Standard-Objekte
  2. Number
  3. Eigenschaften
    1. Number.EPSILON
    2. Number.MAX_SAFE_INTEGER
    3. Number.MAX_VALUE
    4. Number.MIN_SAFE_INTEGER
    5. Number.MIN_VALUE
    6. Number.NEGATIVE_INFINITY
    7. Number.NaN
    8. Number.POSITIVE_INFINITY
    9. Number.prototype
  4. Methoden
    1. Number.isFinite()
    2. Number.isInteger()
    3. Number.isNaN()
    4. Number.isSafeInteger()
    5. Number.parseFloat()
    6. Number.parseInt()
    7. Number.prototype.toExponential()
    8. Number.prototype.toFixed()
    9. Number.prototype.toLocaleString()
    10. Number.prototype.toPrecision()
    11. Number.prototype.toSource()
    12. Number.prototype.toString()
    13. Number.prototype.valueOf()
    14. Number.toInteger()
  5. Vererbung:
  6. Function
  7. Eigenschaften
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
    7. Function.prototype
  8. Methoden
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Eigenschaften
    1. Object.prototype.__count__ [Übersetzen]
    2. Object.prototype.__noSuchMethod__ [Übersetzen]
    3. Object.prototype.__parent__ [Übersetzen]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Methoden
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Übersetzen]
    3. Object.prototype.__lookupGetter__() [Übersetzen]
    4. Object.prototype.__lookupSetter__() [Übersetzen]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf() [Übersetzen]
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString() [Übersetzen]
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch() [Übersetzen]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Übersetzen]
    14. Object.setPrototypeOf() [Übersetzen]