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 et au format suivant :

  1. Les trois premières lettre indiquent le jour
  2. Les trois lettres suivantes indiquent le mois
  3. Les deux chiffres suivants indiquent le jour du mois (et sont complétés avec un 0 devant si besoin)
  4. Les quatre chiffres restants indiquent l'année (si besoin complétées avec des 0 comme préfixe)

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

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
toDateStringChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui

Légende

Support complet  
Support complet

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : edspeedy, SphinxKnight, mdnwebdocs-bot, teoli, tregagnon
Dernière mise à jour par : edspeedy,