# j-Locale

> Este componente establece la configuración regional actual del navegador (formato de número, formato de fecha y formato de hora) según el idioma de navegación.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: es
Content-SHA256: 1a27b42376cc601c5026004c40685f5df8d0c2f2005cc19357073525950bd6c1
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Este componente establece la configuración regional actual del navegador (formato de número, formato de fecha y formato de hora) de acuerdo con `navigatior.language`.

- singleton
- `path` contendrá la configuración regional del navegador actual
- establece `DEF.dateformat` y crea un valor de entorno llamado `[ts]`

__Configuración__:

- `language {String}` opcional, un idioma personalizado (predeterminado: `navigator.language`)
- `requests {Boolean}` opcional, agrega un idioma a cada solicitud (afecta a `DEF.languagehtml`, predeterminado: `false`)

__Ambientes__:

- `[ts]` marca de tiempo completa
- `[date]` única fecha
- `[time]` única vez

__Salida__:

```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étodos__:

- `component.use(language)`

__Idiomas especiales admitidos__:

- `eu` con el dd.MM.aaaa con sistema 24 horas
- `us` con el dd-MM-aaaa con sistema de 12 horas

Úselo con `<ui-component name="locale">`. Cuando el componente aún no está cargado, jComponent lo descarga en el primer uso desde la dirección en `DEF.fallback` (el CDN Componentator de forma predeterminada). Autor: Peter Širka. Fuente: repositorio de componentes Componentator, licencia 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>
```