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 avril 2017.
La méthode [@@toPrimitive]() permet de convertir un objet Date en une valeur primitive.
Syntaxe
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® 2026 Language Specification # sec-date.prototype-%symbol.toprimitive% |