Date.prototype[@@toPrimitive]

La méthode [@@toPrimitive]() permet de convertir un objet Date en une valeur primitive.

Syntaxe

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

Valeur de retour

La valeur primitive de l'objet Date. Selon la valeur de l'argument, la méthode peut renvoyer une chaîne de caractères ou un nombre.

Description

La méthode [@@toPrimitive]() de Date renvoie une valeur primitive qui est un nombre ou une chaîne de caractère.

Si le paramètre hint vaut "string" ou "default", [@@toPrimitive]() tentera d'appeler la méthode toString, si la propriété toString() n'existe pas, elle tentera alors d'appeler la méthode valueOf, si cette dernière n'existe pas non plus, [@@toPrimitive]() lèvera une exception TypeError.

Si le paramètre hint vaut "number", [@@toPrimitive]() tentera d'abord un appel à valueOf() puis ensuite un appel à toString().

Le moteur JavaScript appelle la méthode [@@toPrimitive]() afin de convertir un objet en une valeur primitive. Il est rarement nécessaire d'appeler [@@toPrimitive]() explicitement dans son propre code, le moteur JavaScript l'utilisera automatiquement lorsqu'il détectera un objet là où une valeur primitive est attendue.

Spécifications

Spécification État Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Date.prototype.@@toPrimitive' dans cette spécification.
Standard Définition initiale.
ECMAScript Latest Draft (ECMA-262)
La définition de 'Date.prototype.@@toPrimitive' dans cette spécification.
Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
@@toPrimitiveChrome Support complet 47Edge Support complet 15Firefox Support complet 44IE Aucun support NonOpera Support complet 34Safari Support complet 10WebView Android Support complet 47Chrome Android Support complet 47Firefox Android Support complet 44Opera Android Support complet 34Safari iOS Support complet 10Samsung Internet Android Support complet 5.0nodejs Support complet 6.0.0

Légende

Support complet  
Support complet
Aucun support  
Aucun support

Voir aussi