Date.prototype[@@toPrimitive]
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
| Specification |
|---|
| ECMAScript Language Specification # sec-date.prototype-%symbol.toprimitive% |
Compatibilité des navigateurs
BCD tables only load in the browser