Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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

js
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 :

  1. Les trois premières lettres du nom du jour de la semaine
  2. Les trois premières lettres du nom du mois
  3. Le jour du mois sur deux chiffres, complété à gauche par un zéro si nécessaire
  4. 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()

js
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