Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

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
Eine 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 einen 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
Properties inherited from Function:

Methoden

For methods available on Number instances, see Methods of Number instances.
Number.isNaN()
Gibt an, ob der Wert einer Zahl NaN ist.
Number.isFinite()
Gibt an, ob der Wert einer Zahl ein unendlich Zahl ist.
Number.isInteger()
Gibt an, ob der Wert einer Zahl eine ganze Zahl ist.
Number.isSafeInteger()
Gibt an, ob der Wert einer Zahl eine sichere ganze Zahl ist  (eine ganze Zahl zwischen -(253 -1) und 253 -1).
Number.toInteger()
Wurde eingesetzt um ein Zahl zu einer ganzen Zahl zu konvertieren. Die Funktion wurde entfernt.
Number.parseFloat()
Die Wert ist der gleiche wie bie der parseFloat() Funktion des globelen Objektes.
Number.parseInt()
Die Wert ist der gleiche wie bie der parseInt() Funktion des globelen Objektes.
Methods inherited from Function:

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. Dies 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

Beispiel: Einsatz des Number Objekten 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;

Beispiel: 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, chapter 8.5 The Number Type nach):

var biggestInt = 9007199254740992;
var smallestInt = -9007199254740992;

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

Beispiel: Einsatz von Number zum Konvertieren eines Date objekts

Das Folgende Beispiel Konvertiert ein Data Objekt in einen nummerischen 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("")        // 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 New methods and properties added: EPSILON, isFinite, isInteger, isNaN, parseFloat, parseInt
ECMAScript 2017 Draft (ECMA-262)
Die Definition von 'Number' in dieser Spezifikation.
Entwurf  

Browserkompatibilität

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Ja) (Ja) (Ja) (Ja) (Ja)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Ja) (Ja) (Ja) (Ja) (Ja) (Ja)

Siehe auch

 

Schlagwörter des Dokuments und Mitwirkende

Schlagwörter: 
 Mitwirkende an dieser Seite: schlagi123, fscholz, AngelSankturio
 Zuletzt aktualisiert von: schlagi123,