Date.prototype.toTimeString()

La méthode toTimeString()renvoie la partie « heure » de l'objet Date dans un format lisible par un humain, en anglais américain.

Syntaxe

dateObj.toTimeString()

Valeur de retour

Une chaîne de caractères qui représente l'heure de la date indiquée dans un format anglais américain.

Description

Une instance de Date représente un instant précis dans le temps. Appeler toString() renverra la date formatée de façon à être lisible par un humain, en anglais américain. Pour le moteur JavaScript SpiderMonkey, ceci consiste en la partie « date » (jour, mois, année) suivie de la partie « heure » (heures, minutes, secondes, et fuseau horaire). Parfois, il est préférable d'obtenir seulement la partie « heure » ; c'est ce que renvoie la méthode toTimeString().

La méthode toTimeString() est particulièrement utile parce que les moteurs implémentant ECMA-262 peuvent obtenir des résultats différents avec la méthode toString() (en effet, le format dépend de l'implémentation). Ceci peut empêcher les manipulations de textes simples d'avoir des résultats cohérents au sein des différents moteurs/navigateurs.

Exemple

Utiliser toTimeString()

var d = new Date(1993, 6, 28, 14, 39, 7);

console.log(d.toString());     // Wed Jul 28 1993 14:39:07 GMT-0600 (PDT)
console.log(d.toTimeString()); // 14:39:07 GMT-0600 (PDT)

Spécifications

Spécification État Commentaires
ECMAScript 3rd Edition (ECMA-262) Standard Définition initiale.
ECMAScript 5.1 (ECMA-262)
La définition de 'Date.prototype.toTimeString' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Date.prototype.toTimeString' dans cette spécification.
Standard  
ECMAScript (ECMA-262)
La définition de 'Date.prototype.toTimeString' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
toTimeStringChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 5.5Opera Support complet 5Safari Support complet 1WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0nodejs Support complet 0.1.100

Légende

Support complet  
Support complet

Voir aussi