diff options
| author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 21:46:22 -0500 |
|---|---|---|
| committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 21:46:22 -0500 |
| commit | a065e04d529da1d847b5062a12c46d916408bf32 (patch) | |
| tree | fe0f8bcec1ff39a3c499a2708222dcf15224ff70 /files/fr/web/javascript/reference/objets_globaux/date | |
| parent | 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 (diff) | |
| download | translated-content-a065e04d529da1d847b5062a12c46d916408bf32.tar.gz translated-content-a065e04d529da1d847b5062a12c46d916408bf32.tar.bz2 translated-content-a065e04d529da1d847b5062a12c46d916408bf32.zip | |
update based on https://github.com/mdn/yari/issues/2028
Diffstat (limited to 'files/fr/web/javascript/reference/objets_globaux/date')
| -rw-r--r-- | files/fr/web/javascript/reference/objets_globaux/date/tolocaleformat/index.html | 80 |
1 files changed, 0 insertions, 80 deletions
diff --git a/files/fr/web/javascript/reference/objets_globaux/date/tolocaleformat/index.html b/files/fr/web/javascript/reference/objets_globaux/date/tolocaleformat/index.html deleted file mode 100644 index 70c13e3a25..0000000000 --- a/files/fr/web/javascript/reference/objets_globaux/date/tolocaleformat/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Date.prototype.toLocaleFormat() -slug: Web/JavaScript/Reference/Objets_globaux/Date/toLocaleFormat -tags: - - Date - - JavaScript - - Méthode - - Prototype - - Reference -translation_of: Archive/Web/JavaScript/Date.toLocaleFormat ---- -<div>{{JSRef}} {{Non-standard_header}}</div> - -<p>La méthode non-standard <strong><code>toLocaleFormat()</code></strong> convertit une date en une chaîne de caractères, en utilisant le formatage renseigné. {{jsxref("DateTimeFormat")}} est une alternative standardisée. Voir aussi la nouvelle version de {{jsxref("Date.prototype.toLocaleDateString()")}}.</p> - -<div class="warning"> -<p><strong>Attention</strong>, <strong>cette fonction a été retirée à partir de Firefox 58</strong>. Voir <a href="/fr/docs/Web/JavaScript/Reference/Errors/Deprecated_toLocaleFormat">l'article sur cet avertissement</a> pour plus d'informations et d'éléments pour migrer le code concerné.</p> -</div> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="syntaxbox"><var>dateObj</var>.toLocaleFormat(formatTexte)</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>formatTexte</code></dt> - <dd>Une chaîne de caractères formattée selon les attentes de la fonction <code><a class="external" href="https://www.opengroup.org/onlinepubs/007908799/xsh/strftime.html">strftime()</a></code> en C.</dd> -</dl> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>Une chaîne de caractères qui représente la date indiquée avec le formatage décrit par l'argument.</p> - -<h2 id="Description">Description</h2> - -<p>La méthode <code>toLocaleFormat()</code> apporte un meilleur contrôle sur le formattage des textes produits pour une date. Les noms des mois et des jours de la semaine sont localisés en utilisant la locale du système d'exploitation. Cependant, l'arrangement des jours et mois, ainsi que les autres tâches de localisation ne sont pas prises en charge automatiquement, puisque vous avez le contrôle sur leur ordre d'éxécution. Vous devez faire attention que la chaîne formattée soit localisée correctement en fonction des réglages du systèmes de l'utilisateur. N'oubliez pas que la locale utilisée n'est pas forcément la même que la locale du navigateur.</p> - -<p>Les développeurs de modules et XULRunner doivent savoir que charger directement le chaîne de formattage depuis un fichier <code>.dtd</code> ou <code>.properties</code> en utilisant <code><a class="external" rel="freelink">chrome://</a><em>somedomain</em>/locale/</code><em><code>somefile.ext</code></em> doit être <strong>évité</strong>, car le fichier <code>dtd</code>/<code>properties</code> et la méthode <code>toLocaleFormat()</code> n'utilisent pas forcément la même locale, ce qui peut produire des résultats ambigües, ou des dates illisibles.</p> - -<p>Notez aussi que le comportement de la locale utilisée dépend de la plateforme, et que l'utilisateur peut modifier cette locale. Ainsi, utiliser la locale du système pour choisir le format, peut dans certains cas ne pas être approprié. Vous devriez envisager l'usage des méthodes plus génériques <code>toLocale*</code> de l'objet {{jsxref("Date")}}, ou créer votre localisation personnalisée de la date à partir des méthodes <code>get*</code> de l'objet <code>Date</code>.</p> - -<h2 id="Utiliser_toLocaleFormat()">Utiliser <code>toLocaleFormat()</code></h2> - -<pre class="brush: js example-bad">var aujourdhui = new Date(); -var date = aujourdhui.toLocaleFormat("%A, %B %e, %Y"); // A ne pas faire -</pre> - -<p>Dans cet exemple, <code>toLocaleFormat()</code> renvoie une chaîne de caractères tel que "Wednesday, October 3, 2007". Notez que le format de ce texte dans cet exemple n'est pas correctement localisé, ce qui amène aux problèmes décrits plus haut.</p> - -<h2 id="Prothèse_d'émulation_(polyfill)">Prothèse d'émulation (<em>polyfill</em>)</h2> - -<p>En utilisant la bibliothèque <a href="https://github.com/abritinthebay/datejs/wiki/Format-Specifiers">DateJS</a>, il est possible d'émuler {{jsxref("Date.prototype.toLocaleDateString()")}} pour des environnements qui n'en disposent pas nativement :</p> - -<pre class="brush: js">if (!Date.prototype.toLocaleFormat) { - (function() { - Date.prototype.toLocaleFormat = function(formatString) { - return this.format(formatString); - }; - }()); -}</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<p>Ne fait partie d'aucune spécification. Implémentée avec JavaScript 1.6.</p> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</p> - -<p>{{Compat("javascript.builtins.Date.toLocaleFormat")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}}</li> - <li>{{jsxref("Date.prototype.toLocaleString()")}}</li> - <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> - <li>{{jsxref("Date.prototype.toLocaleTimeString()")}}</li> -</ul> |
