aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSphinxKnight <SphinxKnight@users.noreply.github.com>2021-09-17 22:51:29 +0200
committerGitHub <noreply@github.com>2021-09-17 22:51:29 +0200
commit55863edc03e9372073405d6e85fb0a28fdf65ea9 (patch)
tree1da17695b2919ed7381dbfee176cbda75fc7f524
parent3335211db9ecb67dc0ccd9c4a7c1eb607ffe359f (diff)
downloadtranslated-content-55863edc03e9372073405d6e85fb0a28fdf65ea9.tar.gz
translated-content-55863edc03e9372073405d6e85fb0a28fdf65ea9.tar.bz2
translated-content-55863edc03e9372073405d6e85fb0a28fdf65ea9.zip
Fixes #1919 - updates vs en-US / rm xref macros (#2333)
* Fixes #1919 - updates vs en-US / rm xref macros * Clarify what we mean by using "locale" in the introduction paragraph This commit clarifies what we mean by using "locale" in the introduction paragraph. Co-authored-by: Jb Audras <audrasjb@gmail.com>
-rw-r--r--files/fr/web/javascript/reference/global_objects/date/tolocaletimestring/index.md73
1 files changed, 26 insertions, 47 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/date/tolocaletimestring/index.md b/files/fr/web/javascript/reference/global_objects/date/tolocaletimestring/index.md
index b6e4af66c9..4b7179dfdd 100644
--- a/files/fr/web/javascript/reference/global_objects/date/tolocaletimestring/index.md
+++ b/files/fr/web/javascript/reference/global_objects/date/tolocaletimestring/index.md
@@ -1,39 +1,45 @@
---
title: Date.prototype.toLocaleTimeString()
slug: Web/JavaScript/Reference/Global_Objects/Date/toLocaleTimeString
-tags:
- - Date
- - Internationalisation
- - JavaScript
- - Méthode
- - Prototype
- - Reference
- - i18n
translation_of: Web/JavaScript/Reference/Global_Objects/Date/toLocaleTimeString
original_slug: Web/JavaScript/Reference/Objets_globaux/Date/toLocaleTimeString
+browser-compat: javascript.builtins.Date.toLocaleTimeString
---
{{JSRef}}
-La méthode **`toLocaleTimeString()`** renvoie une chaine de caractères correspondant à l'heure dans la date, exprimée selon une locale. Les arguments `locales` et `options` permettent aux applications de définir le langage utilisé pour les conventions de format et permettent de personnaliser le comportement de la fonction. Les anciennes implémentations ignorent ces arguments, la locale utilisée et le format de la chaine dépendent uniquement de l'implémentation.
+La méthode **`toLocaleTimeString()`** renvoie une chaine de caractères correspondant à l'heure dans la date, exprimée selon une localisation. Les arguments `locales` (définissant la localisation) et `options` permettent aux applications de définir le langage utilisé pour les conventions de format et permettent de personnaliser le comportement de la fonction.
+
+Les anciennes implémentations ignorent ces arguments, la locale utilisée et le format de la chaine dépendent uniquement de l'implémentation.
{{EmbedInteractiveExample("pages/js/date-tolocaletimestring.html")}}
## Syntaxe
- dateObj.toLocaleTimeString([locales [, options]])
+```js
+toLocaleTimeString()
+toLocaleTimeString(locales)
+toLocaleTimeString(locales, options)
+```
### Paramètres
-Voir le tableau de [compatibilité des navigateurs](#compat "#Compatibilit.C3.A9_des_navigateurs") afin de déterminer quels navigateurs respectent les arguments `locales` et `options` ainsi que l'exemple [Vérifier le support des arguments `locales` et `options`](#check) qui permet de détecter cette fonctionnalité.
+Les arguments `locales` et `options` adaptent le comportement de la fonction et permettent aux applications de définir quelles conventions de formatage linguistiques devraient être utilisées. Pour les anciennes implémentations qui ignoraient les arguments `locales` et
+`options`, les `locales` et le format de la chaîne renvoyée dépendent uniquement de l'implémentation.
-{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/DateTimeFormat','Param.C3.A8tres')}}
+Voir la page du constructeur [`Intl.DateTimeFormat()`](/fr/docs/Web/JavaScript/Reference/Intl/DateTimeFormat/DateTimeFormat) pour plus de détails sur ces paramètres et comment les utiliser.
-La valeur par défaut de chacun des composants de la date vaut {{jsxref("undefined")}}, si les propriétés `hour`, `minute`, `second` sont toutes `undefined`, on suppose alors que `hour`, `minute`, et `second` sont "numeric".
+La valeur par défaut de chacun des composants de date/heure vaut [`undefined`](/fr/docs/Web/JavaScript/Reference/Global_Objects/undefined), si les propriétés `hour`, `minute`, `second` sont toutes `undefined`, on suppose alors que `hour`, `minute`, et `second` sont "numeric".
### Valeur de retour
Une chaîne de caractères qui représente l'heure de la date indiquée selon des conventions de locales spécifiques.
+## Performances
+
+Lorsqu'on formate un grand nombre de dates, mieux vaudra créer un objet
+[`Intl.DateTimeFormat`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat) et utiliser la fonction fournie par sa propriété [`format`](/fr/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat/format)
+property.
+
## Exemples
### Utiliser `toLocaleTimeString()`
@@ -50,21 +56,6 @@ console.log(date.toLocaleTimeString());
// → "04:00:00" si exécuté dans une locale fr et le fuseau horaire CEST
```
-### Vérifier le support des arguments `locales` et `options`
-
-Les arguments `locales` et `options` ne sont pas encore supportés par tous les navigateurs. Afin de vérifier si l'implementation utilisée les supporte, vous pouvez utiliser le pré-requis suivant : les locales incorrectes sont rejetées avec une exception` RangeError` :
-
-```js
-function toLocaleTimeStringSupportsLocales() {
- try {
- new Date().toLocaleTimeString("i");
- } catch (e) {
- return e​.name === "RangeError";
- }
- return false;
-}
-```
-
### Utiliser `locales`
Cet exemple montre quelques variations dues aux formats de dates localisés. Afin d'obtenir le langage utilisé au sein de l'interface utilisateur de votre application, vérifiez de bien fournir ce langage (et éventuellement des locales de recours) en utilisant l'argument `locales` :
@@ -114,30 +105,18 @@ console.log(date.toLocaleTimeString("en-US", {hour12: false}));
// → "19:00:00"
```
-## Performance
-
-Pour formater de nombreuses dates, il est préférable de créer un objet {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} et d'utiliser la fonction fournie par sa propriété {{jsxref("DateTimeFormat.prototype.format", "format")}}.
-
## Spécifications
-| Spécification | État | Commentaires |
-| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------------------------------------------------- |
-| {{SpecName('ES3')}} | {{Spec2('ES3')}} | Définition initiale. Implémentée avec JavaScript 1.0. |
-| {{SpecName('ES5.1', '#sec-15.9.5.7', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES5.1')}} |   |
-| {{SpecName('ES6', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES6')}} |   |
-| {{SpecName('ESDraft', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ESDraft')}} |   |
-| {{SpecName('ES Int 1.0', '#sec-13.3.3', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES Int 1.0')}} | Définition des arguments `locales` et `options`. |
-| {{SpecName('ES Int 2.0', '#sec-13.3.3', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES Int 2.0')}} |   |
-| {{SpecName('ES Int Draft', '#sec-Date.prototype.toLocaleTimeString', 'Date.prototype.toLocaleTimeString')}} | {{Spec2('ES Int Draft')}} |   |
+{{Specifications}}
## Compatibilité des navigateurs
-{{Compat("javascript.builtins.Date.toLocaleTimeString")}}
+{{Compat}}
## Voir aussi
-- {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}}
-- {{jsxref("Date.prototype.toLocaleDateString()")}}
-- {{jsxref("Date.prototype.toLocaleString()")}}
-- {{jsxref("Date.prototype.toTimeString()")}}
-- {{jsxref("Date.prototype.toString()")}}
+- [`Intl.DateTimeFormat`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat)
+- [`Date.prototype.toLocaleDateString()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString)
+- [`Date.prototype.toLocaleString()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleString)
+- [`Date.prototype.toTimeString()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date/toTimeString)
+- [`Date.prototype.toString()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date/toString)