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

BrowserkompatibilitÀt

BCD tables only load in the browser

Siehe auch