Date : méthode toTimeString()
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 toTimeString() des instances de Date retourne une chaîne de caractères représentant la partie heure de cette date interprétée dans le fuseau horaire local.
Exemple interactif
const event = new Date("August 19, 1975 23:15:30");
console.log(event.toTimeString());
// Résultat attendu : "23:15:30 GMT+0200 (CEST)"
// Remarque : votre fuseau horaire peut varier
Syntaxe
toTimeString()
Paramètres
Aucun.
Valeur de retour
Une chaîne de caractères représentant la partie heure de la date indiquée (voir la description pour le format). Retourne "Invalid Date" si la date est invalide.
Description
Les instances de Date représentent un point précis dans le temps. toTimeString() interprète la date dans le fuseau horaire local et formate la partie heure en anglais. Elle utilise toujours le format HH:mm:ss GMT±xxxx (TZ), où :
| Format de chaîne | Description |
|---|---|
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) |
±xxxx |
Le décalage horaire local — deux chiffres pour les heures et deux chiffres pour les minutes (ex. -0500, +0800) |
TZ |
Le nom du fuseau horaire (ex. PDT, PST) |
Par exemple : « 04:42:04 GMT+0000 (Coordinated Universal Time) ».
- Pour obtenir uniquement la partie date, utilisez la méthode
toDateString(). - Pour obtenir à la fois la date et l'heure, utilisez la méthode
toString(). - Pour interpréter la date en UTC plutôt qu'en fuseau horaire local, utilisez la méthode
toUTCString(). - Pour mettre en forme l'heure dans un format plus adapté à l'utilisateur (par exemple, la localisation), utilisez la méthode
toLocaleTimeString().
Exemple
Utiliser la méthode toTimeString()
const d = new Date(0);
console.log(d.toString()); // "Thu Jan 01 1970 00:00:00 GMT+0000 (Coordinated Universal Time)"
console.log(d.toTimeString()); // "00:00:00 GMT+0000 (Coordinated Universal Time)"
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.totimestring |
Compatibilité des navigateurs
Voir aussi
- La méthode
Date.prototype.toLocaleTimeString() - La méthode
Date.prototype.toDateString() - La méthode
Date.prototype.toString()