Date : méthode toString()

Exemple interactif

const event = new Date("August 19, 1975 23:15:30");

console.log(event.toString());
// Résultat attendu : "Tue Aug 19 1975 23:15:30 GMT+0200 (CEST)"
// Remarque : votre fuseau horaire peut varier

Syntaxe

toString()

Paramètres

Aucun.

Valeur de retour

Une chaîne de caractères représentant la date indiquée (voir la description pour le format). Retourne "Invalid Date" si la date est non valide.

Description

La méthode toString() fait partie du protocole de contrainte de type. Comme Date possède une méthode [Symbol.toPrimitive](), cette méthode prend toujours le dessus sur toString() lorsqu'un objet Date est implicitement contraint en une chaîne de caractères. Cependant, Date.prototype[Symbol.toPrimitive]() appelle toujours this.toString() en interne.

L'objet Date remplace la méthode toString() de Object. Date.prototype.toString() retourne une chaîne de caractères représentant la date interprétée dans le fuseau horaire local, contenant à la fois la date et l'heure — elle concatène la représentation textuelle définie dans toDateString() et toTimeString(), en ajoutant un espace entre les deux. Par exemple : « Thu Jan 01 1970 00:00:00 GMT+0000 (Coordinated Universal Time) ».

Date.prototype.toString() doit être appelée sur des instances de Date. Si la valeur de this n'hérite pas de Date.prototype, une TypeError est levée.

• Pour obtenir uniquement la partie date, utiliser toDateString().
• Pour obtenir uniquement la partie heure, utiliser toTimeString().
• Pour interpréter la date en UTC plutôt qu'en fuseau horaire local, utiliser toUTCString().
• Pour mettre en forme la date dans un format plus adapté à l'utilisateur·ice (par exemple, la localisation), utiliser toLocaleString().

Exemples

Utiliser la méthode toString()

const d = new Date(0);
console.log(d.toString()); // "Thu Jan 01 1970 00:00:00 GMT+0000 (Coordinated Universal Time)"

Spécifications

Compatibilité des navigateurs

Voir aussi

• La méthode Object.prototype.toString()
• La méthode Date.prototype.toDateString()
• La méthode Date.prototype.toLocaleString()
• La méthode Date.prototype.toTimeString()