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 (2⁵³ -1).
Number.MAX_VALUE: Die größte repräsentierbare Zahl.
Number.MIN_SAFE_INTEGER: Die kleinste sichere Ganzzahl in JavaScript (-(2⁵³ -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 (en-US): 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 -(2⁵³ -1) und 2⁵³ -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 (en-US). Das Prototyp Objekt des Number Konstruktors kann verändert werden, um alle Instanzen von Number zu beeinflussen.

Methoden

{{page('/de/docs/Web/JavaScript/Reference/Global_Objects/Number/prototype', 'Methoden')}}

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

BCD tables only load in the browser

Siehe auch

NaN
Das globale Objekt Math
Number type in details