MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

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 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 Latest Draft (ECMA-262)
La définition de 'Date.prototype.@@toPrimitive' dans cette spécification.
Projet  

Compatibilité des navigateurs

FonctionnalitéChromeFirefoxEdgeInternet ExplorerOperaSafari
Support simple?44????
FonctionnalitéAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Support simple???44???

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,