Date : méthode toDateString()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode toDateString() des instances de Date retourne une chaîne de caractères représentant la partie date de cette date, interprétée selon le fuseau horaire local.
Exemple interactif
const event = new Date(1993, 6, 28, 14, 39, 7);
console.log(event.toString());
// Résultat attendu : "Wed Jul 28 1993 14:39:07 GMT+0200 (CEST)"
// Remarque : votre fuseau horaire peut varier
console.log(event.toDateString());
// Résultat attendu : "Wed Jul 28 1993"
Syntaxe
toDateString()
Paramètres
Aucun.
Valeur de retour
Une chaîne de caractères représentant la partie date de la date donnée (voir la description pour le format). Retourne "Invalid Date" si la date est invalide.
Description
Les instances de Date représentent un point précis dans le temps. toDateString() interprète la date selon le fuseau horaire local et formate la partie date en anglais. Elle utilise toujours le format suivant, séparé par des espaces :
- Les trois premières lettres du nom du jour de la semaine
- Les trois premières lettres du nom du mois
- Le jour du mois sur deux chiffres, complété à gauche par un zéro si nécessaire
- L'année sur au moins quatre chiffres, complétée à gauche par des zéros si nécessaire. Peut avoir un signe négatif
Par exemple : « Thu Jan 01 1970 ».
- Si vous souhaitez obtenir uniquement la partie heure, utilisez la méthode
toTimeString(). - Si vous souhaitez obtenir la date et l'heure, utilisez la méthode
toString(). - Si vous souhaitez que la date soit interprétée en UTC au lieu du fuseau horaire local, utilisez la méthode
toUTCString(). - Si vous souhaitez formater la date dans un format plus adapté à l'utilisateur·ice (par exemple, localisé), utilisez la méthode
toLocaleDateString().
Exemples
>Utiliser la méthode toDateString()
const d = new Date(0);
console.log(d.toString()); // "Thu Jan 01 1970 00:00:00 GMT+0000 (Coordinated Universal Time)"
console.log(d.toDateString()); // "Thu Jan 01 1970"
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-date.prototype.todatestring> |
Compatibilité des navigateurs
Voir aussi
- La méthode
Date.prototype.toLocaleDateString() - La méthode
Date.prototype.toTimeString() - La méthode
Date.prototype.toString()