Date : méthode toDateString()

Baseline Large disponibilité

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.

Dans cet article

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()

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.

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()

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"