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 pass, 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 2017 Draft (ECMA-262) La définition de 'Date.prototype.@@toPrimitive' dans cette spécification. |
Projet |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Support simple | ? | 44.0 (44.0) | ? | ? | ? |
| Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Support simple | ? | ? | 44.0 (44.0) | ? | ? | ? |