La méthode toString()
renvoie une chaîne de caractères représentant l'objet Date
.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
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 (ECMA-262) La définition de 'Date.prototype.toString' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
Les données de compatibilité de ce tableau ont été générées à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request https://github.com/mdn/browser-compat-data.