# j-Locale

> Ce composant définit les paramètres régionaux actuels du navigateur (format numérique, format de date et format d'heure) en fonction du navigateur.langue.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: fr
Content-SHA256: 4f7a11cac84fbcd4af75287303190cf93f02b582ea13c56752f3405b5f18b933
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Ce composant définit les paramètres régionaux actuels du navigateur (format numérique, format de date et format d'heure) en fonction du `navigatior.language`.

- singleton
- `path` contiendra les paramètres régionaux du navigateur actuel
- définit `DEF.dateformat` et crée une valeur d'environnement appelée `[ts]`

__Configuration__ :

- `language {String}` en option, une langue personnalisée (par défaut : `navigator.language`)
- `requests {Boolean}` facultatif, ajoute une langue à chaque requête (cela affecte `DEF.languagehtml`, par défaut : `false`)

__Environnements__ :

- `[ts]` horodatage complet
- `[date]` uniquement la date
- `[time]` seul temps

__Sortie__ :

```js
{
	dt: 'yyyy–MM–dd', // date format
	nf: 1,  // number format: 1 = 100 000.123, 2 = 100 000,123, 3 = 100.000,123, 4 = 100,000.123
	fdw: 0, // first day of week
	tf: 24  // time format: 12, 24
}
```

__Méthodes__ :

- `component.use(language)`

__Langues spéciales prises en charge__ :

- `eu` avec le jj.MM.aaaa avec un système 24 heures
- `us` avec le MM-jj-aaaa avec un système 12 heures

Utilisez-le avec `<ui-component name="locale">`. Lorsque le composant n'est pas encore chargé, jComponent le télécharge lors de la première utilisation depuis l'adresse dans `DEF.fallback` (le CDN Componentator par défaut). Auteur : Peter Širka. Source : le référentiel de composants Componentator, licence MIT.

```html example.html
<ui-component name="locale" path="mylocale"></ui-component>
<hr />
<pre><ui-bind path="mylocale" config="text:JSON.stringify(value, null, '  ')"></ui-bind></pre>
<ui-bind path="testvalue" config="template" class="mt10 block">
	<script type="text/html">
		<div>{{ value.date | format }}</div>
		<div>{{ value.date | format('[ts]') }}</div>
		<div>{{ value.number | format(2) }}</div>
	</script>
</ui-bind>

<script>
	var testvalue = { date: new Date(), number: 1234567.89 };
</script>
```