La méthode toString()
renvoie une chaîne de caractères représentant l'objet Date
.
Syntaxe
dateObj.toString()
Valeur de retour
Une chaîne de caractères représentant la date indiquée.
Description
L'objet Date
remplace la méthode toString()
de l'objet Object
; il n'hérite pas de Object.prototype.toString()
. Pour les objets Date
, la méthode toString()
renvoie une représentation textuelle de l'objet.
La méthode toString()
renvoie toujours une chaîne de caractères représentant une date en anglais américain.
JavaScript appelle la méthode toString()
automatiquement quand une date doit être representée sous forme d'un texte ou quand une date est référencée lors d'une concatenation de chaînes de caractères.
toString()
est une méthode générique. Si this
n'est pas une instance de Date
, elle renverra "Invalid Date".
Exemples
Utiliser toString()
L'exemple suivant assigne la valeur de toString()
de l'objet Date
à maVar
:
var x = new Date(); var maVar = x.toString(); // assigne une valeur à maVar similaire à : // Mon Sep 28 1998 14:36:22 GMT-0700 (PDT)
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.0. |
ECMAScript 5.1 (ECMA-262) La définition de 'Date.prototype.toLocaleTimeString' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Date.prototype.toString' dans cette spécification. |
Standard | |
ECMAScript 2017 Draft (ECMA-262) La définition de 'Date.prototype.toString' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |
Méthode générique | ? | 41 (41) | ? | ? | ? |
Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |
Méthode générique | ? | ? | 41.0 (41) | ? | ? | ? |