Date.prototype[@@toPrimitive]

Die [@@toPrimitive]() Methode konvertiert ein date Objekt in einen primitiven Wert.
 

Syntax

Date()[Symbol.toPrimitive](hint);

Rückgabewert

Der primitive Wert des gegebenen Date Objektes. Abhängig vom übergebenen Parameter kann die Methode einen String oder eine Zahl zurückgeben.

Beschreibung

[@@toPrimitive]() ist eine Methode des date Objektes, welche einen primitiven Wert zurück gibt, was vom Typ number oder String sein kann.

Wenn der Parameter hint die Wert "string" oder "default" enthält, wird versucht die toString Methode aufzurufen. Wenn diese Methode nicht existiert, wird versucht die valueOf Methode aufzurufen. Wenn diese wiederum nicht existiert wirft [@@toPrimitive]() einen TypeError.

Wenn der Parameter hint den Wert "number" hat, wird als erstes versucht die  valueOf Methode aufzurufen. Wenn diese nicht existiert, wird die toString Methode aufgerufen.

JavaScript ruft die [@@toPrimitive]() auf, um ein Objekt in einen primitiven Wert zu konvertieren. Explizit muss man diese Methode extrem selten aufrufen. JavaScript ruft diese Methode automatisch auf, wenn ein Objekt an Stellen verwendet wird, an denen ein primitiver Wert erwartet wird.

Spezifikationen

Spezifikation Status Kommentar
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Date.prototype.@@toPrimitive' in dieser Spezifikation.
Standard Initiale Definition.
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Date.prototype.@@toPrimitive' 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
@@toPrimitiveChrome Vollständige Unterstützung 47Edge Vollständige Unterstützung 15Firefox Vollständige Unterstützung 44IE Keine Unterstützung NeinOpera Vollständige Unterstützung 34Safari ? WebView Android Vollständige Unterstützung 47Chrome Android Vollständige Unterstützung 47Firefox Android Vollständige Unterstützung 44Opera Android Vollständige Unterstützung 34Safari iOS ? Samsung Internet Android Vollständige Unterstützung 5.0nodejs Vollständige Unterstützung 6.0.0

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Keine Unterstützung  
Keine Unterstützung
Kompatibilität unbekannt  
Kompatibilität unbekannt

Siehe auch