Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

toLocaleTimeString, méthode (Date) (JavaScript)

Retourne une heure convertie en valeur de chaîne en fonction des paramètres régionaux définis pour l'environnement hôte ou de paramètres régionaux spécifiques.

dateObj.toLocaleTimeString([locales][, options])

dateObj

Requis. Objet Date.

locales

Optionnel. Tableau de chaînes de paramètres régionaux qui contiennent une ou plusieurs balises de langue ou de paramètres régionaux. Si vous incluez plusieurs chaînes de paramètres régionaux, répertoriez-les dans l'ordre de priorité décroissant afin que la première entrée soit la valeur par défaut. Si vous omettez ce paramètre, les paramètres régionaux par défaut du runtime JavaScript sont utilisés.

options

Optionnel. Objet qui contient une ou plusieurs propriétés qui spécifient les options de comparaison.

À partir d'Internet Explorer 11, toLocaleTimeString utilise Intl.DateTimeFormat en interne pour mettre en forme l'heure, ce qui ajoute la prise en charge des paramètres locales et options. Pour plus d'informations sur ces paramètres, consultez Intl.DateTimeFormat.

Remarque importante Important

Les paramètres locales et options ne sont pas pris en charge dans tous les modes de document et toutes les versions de navigateur. Pour plus d'informations, consultez la section Configuration requise.

Lorsque vous utilisez toLocaleTimeString en mode de document Internet Explorer 10 (mode standard), mode de document Internet Explorer versions antérieures, et mode Quirks :

  • il retourne une valeur de chaîne contenant une heure dans le fuseau actuel.

  • L'heure retournée est exprimée dans le format par défaut défini par les paramètres régionaux de l'environnement hôte.

Si vous omettez le paramètre locales, la valeur de retour de cette méthode ne peut pas être utilisée de manière fiable dans un script, étant donné qu'elle varie d'un ordinateur à un autre. Dans ce scénario, utilisez la méthode uniquement pour mettre en forme le texte – jamais dans le cadre d'un calcul.

L'exemple suivant montre comment utiliser la méthode toLocaleTimeString avec des paramètres régionaux spécifiés et des options de comparaison.

var date = new Date(Date.UTC(2013, 1, 1, 14, 0, 0));
var options = { weekday: "long", year: "numeric", month: "short",
    day: "numeric" };

// Using I18N toLocaleString
document.write(date.toLocaleDateString("en-US"));
document.write(date.toLocaleDateString("ja-JP"));
document.write(date.toLocaleDateString("ar-SA", options));
document.write(date.toLocaleDateString("hi-IN", options));

// Output:
// ‎‎6‎:‎00‎:‎00‎ ‎AM ‎ 
// 6‎:‎00‎:‎00‎
// ‏الجمعة‏, ‏٢٠‏ ‏ربيع الأول‏, ‏١٤٣٤ ٠٦‎:‎٠٠‎:‎٠٠‎ ‎ص
// ‎शुक्रवार‎, ‎01‎ ‎फरवरी‎ ‎2013 06:00:00

Pris en charge dans les modes de document suivants : Quirks, Internet Explorer 6 (mode standard), Internet Explorer 7 (mode standard), Internet Explorer 8 (mode standard), Internet Explorer 9 (mode standard), Internet Explorer 10 (mode standard), Internet Explorer 11 (mode standard). Également pris en charge dans les applications Store (Windows 8 et Windows Phone 8.1). Consultez Informations de version.

Paramètres locales et options :

Pris en charge dans le mode de document Internet Explorer 11 (mode standard). Également pris en charge dans les applications Store (Windows 8.1 et Windows Phone 8.1). Consultez Informations de version.

Non pris en charge dans les modes de document suivants : Quirks, Internet Explorer 6 (mode standard), Internet Explorer 7 (mode standard), Internet Explorer 8 (mode standard), Internet Explorer 9 (mode standard), Internet Explorer 10 (mode standard). Non pris en charge dans Windows 8.

Ajouts de la communauté

Afficher:
© 2014 Microsoft