Date.prototype.toString()

La méthode toString() renvoie une chaîne de caractères représentant l'objet Date.

Exemple interactif

Syntaxe

js
dateObj.toString();

Valeur de retour

Une chaîne de caractères représentant la date indiquée.

Description

L'objet Date remplace la méthode toString() de l'objet Object ; il n'hérite pas de Object.prototype.toString(). Pour les objets Date, la méthode toString() renvoie une représentation textuelle de l'objet.

La méthode toString() renvoie toujours une chaîne de caractères représentant une date en anglais américain. Ce format a été standardisé avec ES2018 et peut être décrit de la façon suivante :

  • Le jour de la semaine avec les trois premières lettres du jour en anglais (ex. « Sat »)
  • Un espace
  • Le mois avec les trois premières lettres du mois en anglais (ex. « Sep »)
  • Un espace
  • La date du jour dans le mois sur deux chiffres (ex. « 01 »)
  • Un espace
  • L'année sur 4 chiffres (ex. « 2018 »)
  • Un espace
  • L'heure sur deux chiffres (ex. « 14 »)
  • Un deux-points (:)
  • Les minutes sur deux chiffres (ex. « 53 »)
  • Un deux-points (:)
  • Les secondes sur deux chiffres (ex. « 26 »)
  • Un espace
  • La chaîne de caractères « GMT »
  • Le signe du décalage horaire par rapport à GMT :
    • La chaîne "+" pour les décalages positifs (0 ou plus)
    • La chaîne "-" pour les décalages strictement négatifs
  • L'heure de décalage sur deux chiffres
  • Les minutes de décalage sur deux chiffres
  • Et, éventuellement, le nom du fuseau horaire avec
    • Un espace
    • Une parenthèse ouvrante (« ( »)
    • Une chaîne de caractères, pouvant varier selon l'implémentation, qui désigne le fuseau horaire. Ce peut être une abréviation ou un nom complet.
    • Une parenthèse fermante (« ) »)

Avant ES2018, le format de la chaîne de caractères renvoyé pouvait varier selon l'implémentation.

JavaScript appelle la méthode toString() automatiquement quand une date doit être representée sous forme d'un texte ou quand une date est référencée lors d'une concatenation de chaînes de caractères.

toString() est une méthode générique. Si this n'est pas une instance de Date, elle renverra "Invalid Date".

Exemples

Utiliser toString()

L'exemple suivant assigne la valeur de toString() de l'objet Date à maVar :

js
var x = new Date();
var maVar = x.toString(); // assigne une valeur à maVar similaire à :
// Mon Sep 28 1998 14:36:22 GMT-0700 (PDT)

Spécifications

Specification
ECMAScript Language Specification
# sec-date.prototype.tostring

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi