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

Syntaxe

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 :

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

Spécification État Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
La définition de 'Date.prototype.toLocaleTimeString' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Date.prototype.toString' dans cette spécification.
Standard  
ECMAScript 2018 (ECMA-262)
La définition de 'Date.prototype.toString' dans cette spécification.
Standard Standardisation du format produit par Date.prototype.toString()
ECMAScript Latest Draft (ECMA-262)
La définition de 'Date.prototype.toString' dans cette spécification.
Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung InternetNode.js
Support simpleChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui

Légende

Support complet  
Support complet

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight, teoli, tregagnon
Dernière mise à jour par : SphinxKnight,