Number

Das JavaScript Objekt Number ist ein Container Objekt (Wrapper Objekt), welches das Arbeiten mit numerischen Werten erlaubt. Ein Number Objekt wird erzeugt indem der Number() Konstruktor verwendet wird.

Syntax

new Number(value);

Parameter

value
Ein numerischer Wert, der als Objekt erstellt werden soll.

Beschreibung

Die hauptsächlichen Nutzungen des Number Objektes sind:

  • Wenn der Parameter nicht zu einer Nummer konvertiert werden kann, wird NaN zurückgegeben.
  • In einem nicht-Konstruktor Kontext (z. B. ohne den new Operator) führt Number zu einer Typkonvertierung.

Eigenschaften

Number.EPSILON
Das kleinste Intervall zwischen zwei repräsentierbaren Zahlen.
Number.MAX_SAFE_INTEGER
Die größte sichere Ganzzahl in JavaScript (253 -1).
Number.MAX_VALUE
Die größte repräsentierbare Zahl.
Number.MIN_SAFE_INTEGER
Die kleinste sichere Ganzzahl in JavaScript (-(253 -1)).
Number.MIN_VALUE
Die kleinste positive repräsentierbare Zahl. Das ist die positive Zahl, die am nächsten an 0 ist (aber nicht 0 ist).
Number.NaN
Spezieller "keine Zahl" Wert.
Number.NEGATIVE_INFINITY
Spezieller Wert welcher negativ Unendlich repräsentiert; wird bei einem Overflow zurückgegeben.
Number.POSITIVE_INFINITY
Spezieller Wert welcher positiv Unendlich repräsentiert; wird bei einem Overflow zurückgegeben.
Number.prototype
Ermöglicht das Hinzufügen von Eigenschaften zu einem Number Objekt

Methoden

Number.isNaN()
Gibt an, ob der übergebene Wert NaN ist.
Number.isFinite()
Gibt an, ob der übergebene Wert eine endliche Zahl ist.
Number.isInteger()
Gibt an, ob der übergebene Wert eine ganze Zahl ist.
Number.isSafeInteger()
Gibt an, ob der der übergebene Wert eine sichere ganze Zahl ist (eine ganze Zahl zwischen -(253 -1) und 253 -1).
Number.toInteger()
Wurde eingesetzt um eine Zahl zu einer ganzen Zahl zu konvertieren. Die Funktion wurde entfernt.
Number.parseFloat()
Der Wert ist der gleiche wie bei der parseFloat() Funktion des globalen Objektes.
Number.parseInt()
Der Wert ist der gleiche wie bei der parseInt() Funktion des globalen Objektes.

Number Instanzen

Alle Instanzen von Number erben von Number.prototype. Das Prototyp Objekt des Number Konstruktors kann verändert werden, um alle Instanzen von Number zu beeinflussen.

Methoden

Number.prototype.toExponential()
Gibt eine Zeichenkette (string) zurück, die die Nummer in Exponential Notation repräsentiert.
Number.prototype.toFixed()
Gibt eine Zeichenkette (string) zurück, die die Nummer als Festkommazahl repräsentiert.
Number.prototype.toLocaleString()
Gibt eine Zeichenkette (string) zurück, die die sprachenübliche Repräsentation der Nummer repräsentiert. Überschreibt die  Object.prototype.toLocaleString() Methode.
Number.prototype.toPrecision()
Gibt eine Zeichenzette (string) zurück, die die Zahl in einer bestimmten Genauigkeit als Festkommazahl repräsentiert.
Number.prototype.toSource()
Gibt ein Objektliteral zurück, welches das Number Objekt spezifiziert. Diese Methode kann genutzt werden, um ein neues Objekt zu erzeugen. Überschreibt die Object.prototype.toSource() Methode.
Number.prototype.toString()
Gibt eine Zeichenkette (string) zurück, die die Zahl in einer bestimmten Basis repräsentiert. Überschreibt die Object.prototype.toString() Methode.
Number.prototype.valueOf()
Gibt einen primitiven Wert des Objektes zurück. Überschreibt die Object.prototype.valueOf() Methode.

Beispiele

Einsatz des Number Objektes zur Zuweisung von numerischen Variablen

Das folgende Beispiel benutzt Eigenschaften des Number Objektes um Werte zu numerischen Variablen zuzuweisen:

var biggestNum = Number.MAX_VALUE;
var smallestNum = Number.MIN_VALUE;
var infiniteNum = Number.POSITIVE_INFINITY;
var negInfiniteNum = Number.NEGATIVE_INFINITY;
var notANum = Number.NaN;

Ganzzahlbereich von Number

Das folgende Beispiel zeigt die kleinste und größte Ganzzahl, welche mit Number Objekten repräsentiert werden kann (für Details siehe im ECMAScript Standard Kapitel 6.1.6 The Number Type):

var biggestInt = 9007199254740992;
var smallestInt = -9007199254740992;

Wenn Daten im JSON Format eingelesen werden und Ganzzahlen den oben gezeigten Bereich übersteigen, kann es passieren, dass Fehler beim Erstellen von Number Objekten auftreten. Mit dem Einsatz von String können solche Fehler umgangen werden. 

Einsatz von Number zum Konvertieren eines Date Objekts

Das folgende Beispiel konvertiert ein Date Objekt in einen numerischen Wert. Dazu wird Number als Funktion verwendet:

var d = new Date("December 17, 1995 03:24:00");
print(Number(d));

Ausgabe: "819199440000".

Konvertiertung von Strings zu Nummern

Number('123')     // 123
Number('12.3')    // 12.3
Number('123e-1')  // 12.3
Number('')        // 0
Number('0x11')    // 17
Number('0b11')    // 3 
Number('0o11')    // 9
Number('foo')     // NaN
Number('100a')    // NaN

Spezifikationen

Spezifikation Status Kommentar
ECMAScript 1st Edition (ECMA-262) Standard Initiale Definition. Implementiert in JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
Die Definition von 'Number' in dieser Spezifikation.		 Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Number' in dieser Spezifikation.		 Standard

Neue Methoden und Properties hinzugefügt: EPSILON, isFinite, isInteger, isNaN, parseFloat, parseInt
ECMAScript (ECMA-262)
Die Definition von 'Number' in dieser Spezifikation.		 Lebender Standard  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
Number() constructorChrome Vollständige Unterstützung 1Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 1IE Vollständige Unterstützung 3Opera Vollständige Unterstützung 3Safari Vollständige Unterstützung 1WebView Android Vollständige Unterstützung 1Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung 10.1Safari iOS Vollständige Unterstützung 1Samsung Internet Android Vollständige Unterstützung 1.0nodejs Vollständige Unterstützung 0.1.100

Legende

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

Siehe auch