La méthode toDateString()
renvoie la date contenue dans un objet Date
sous la forme d'une chaîne de caractères lisible par un humain, en anglais américain.
Syntaxe
dateObj.toDateString()
Valeur de retour
Une chaîne de caractères qui représente la date indiquée, dans un format anglais américain.
Description
Les instances de Date
représentent un point précis dans le temps. Appeler toString
retournera la date formatée sous une forme lisible par un humain, en anglais américain. Pour le moteur JavaScript SpiderMonkey, ceci consiste en : la partie « date » (jour, mois et année) suivie de la partie « heure » (heures, minutes, secondes et fuseau horaire). Il est parfois préférable d'obtenir uniquement la partie « date » ; ceci est possible grâce à la méthode toDateString()
.
La méthode toDateString()
est particulièrement utile car, pour les moteurs implémentant fidèlement ECMA-262, il peut y avoir certaines différences dans la chaîne de caractères produite par toString()
sur les objets Date
. Le format dépend de l'implémentation et les techniques simples de découpage de texte peuvent ne pas produire un résultat cohérent à travers les différents moteurs.
Exemples
Utiliser simplement toDateString()
var d = new Date(1993, 6, 28, 14, 39, 7); console.log(d.toString()); // écrit Wed Jul 28 1993 14:39:07 GMT-0600 (PDT) console.log(d.toDateString()); // écrit Wed Jul 28 1993
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 3rd Edition (ECMA-262) | Standard | Définition initiale. |
ECMAScript 5.1 (ECMA-262) La définition de 'Date.prototype.toDateString' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Date.prototype.toDateString' dans cette spécification. |
Standard | |
ECMAScript 2017 Draft (ECMA-262) La définition de 'Date.prototype.toDateString' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |
Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |