Date : méthode toUTCString()
Baseline
Widely available
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 toUTCString() des instances de Date retourne une chaîne de caractères représentant cette date au format défini par la RFC 7231 (angl.), les années négatives étant autorisées. Le fuseau horaire utilisé est toujours UTC. toGMTString() est un alias de cette méthode.
Exemple interactif
const event = new Date("14 Jun 2017 00:00:00 PDT");
console.log(event.toUTCString());
// Résultat attendu : "Wed, 14 Jun 2017 07:00:00 GMT"
Syntaxe
toUTCString()
Paramètres
Aucun.
Valeur de retour
Une chaîne de caractères représentant la date indiquée en temps UTC (voir la description pour le format). Retourne "Invalid Date" si la date est invalide.
Description
La valeur retournée par toUTCString() est une chaîne de caractères au format Www, dd Mmm yyyy HH:mm:ss GMT, où :
| Format de chaîne | Description |
|---|---|
Www |
Jour de la semaine, en trois lettres (ex. Sun, Mon) |
dd |
Jour du mois, sur deux chiffres (avec zéro initial si nécessaire) |
Mmm |
Mois, en trois lettres (ex. Jan, Feb) |
yyyy |
Année, sur quatre chiffres ou plus (avec zéros initiaux si nécessaire) |
HH |
Heure, sur deux chiffres (avec zéro initial si nécessaire) |
mm |
Minute, sur deux chiffres (avec zéro initial si nécessaire) |
ss |
Secondes, sur deux chiffres (avec zéro initial si nécessaire) |
Alias
L'API Date de JavaScript s'est inspirée de la bibliothèque Java java.util.Date (cette dernière étant devenue de facto obsolète depuis Java 1.1 en 1997). En particulier, la classe Java Date possédait une méthode nommée toGMTString — un nom mal choisi, car l'Heure moyenne de Greenwich n'est pas équivalente au Temps universel coordonné, alors que les dates JavaScript fonctionnent toujours en temps UTC. Pour des raisons de compatibilité web, toGMTString reste un alias de toUTCString, et ils réfèrent au même objet fonction. Cela signifie :
Date.prototype.toGMTString.name === "toUTCString";
Exemples
Utiliser la méthode toUTCString()
const d = new Date(0);
console.log(d.toUTCString()); // 'Thu, 01 Jan 1970 00:00:00 GMT'
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.toutcstring |
Compatibilité des navigateurs
Voir aussi
- La méthode
Date.prototype.toLocaleString() - La méthode
Date.prototype.toString() - La méthode
Date.prototype.toISOString()