Intl

Propiedades

Intl.Collator

Constructor para collators, objetos que permiten la comparacin de cadenas con sensibilidad al lenguaje.

Intl.DateTimeFormat

Constructor para objetos que permiten el formato de fecha y tiempos con sensibilidad al lenguaje.

Intl.NumberFormat

Constructor para objetos que permiten el formato de nmeros con sensibilidad al lenguaje.

Intl.PluralRules

Por definir

Mtodos

Intl.getCanonicalLocales()

Mtodo que retorna los nombres cannicos de las diferentes variantes de lenguaje.

Identificacin de variantes de lenguaje y negociacin

Los constructores de internacionalizacin, as como otros metodos de constructores sensibles al lenguaje (listados bajo Ver ms) siguen un mismo patrn para identificar variantes de lenguaje y determinar aquella a utilizar: todos aceptan los argumentos locales y options, y negocian las variantes requeridas contra aquellas que soportan utilizando un algoritmo especificado en la propiedad options.localeMatcher.

locales

El argumento locales debe ser tanto una cadena que contenga una Etiqueta de Idioma BCP 47, o una matriz de etiquetas de dicho idioma. Si el argumento locales no es provisto o es indefinido, ser usado la localicacion predeterminada.

Una etiqueta de idioma BCP 47 define un idioma y minimamente contiene un cdigo primario de idioma. En estos la forma mas comun puede contener, : un cdigo de idioma, un cdigo del sistema de escritura, y un cdigo de pas o regin, todo separado por guiones. Mientras la etiqueta no es case sensitive, es recomendable usar un titulo para el cdigo del sistema de escritura, maysculas para el pas y regin y minsculas para todo lo dems.

Ejemplos:

• "hi": Hindi (idioma principal).
• "de-AT": Alemn usado en Austria (idioma principal con cdigo del pas).
• "zh-Hans-CN": Escritura China en caracteres simplificados como se usa en China (idioma principal con cdigo de escritura y cdigo del pas).

Las subetiquetas que identifican idiomas, scripts, pases (regiones), y (raramente utilizadas) variantes en las etiquetas de idiomas BCP 47 pueden ser encontradas en el Registro de subetiquetas de idioma de la IANA.

BCP 47 permite tambin extensiones. Las funciones de internacionalizacin de JavaScript utilizan la extensin "u" (Unicode), misma que puede emplearse para requerir personalizacion de los objetos Collator, NumberFormat, o DateTimeFormat. A continuacin algunos ejemplos:

• "de-DE-u-co-phonebk": Utiliza la variante de gua telefnica del orden de clasificacin alemn, que expande las vocales con umlaut a pares de caracteres: ae, oe, ue.
• "th-TH-u-nu-thai": Utiliza dgitos tailandeses (, , , , , , , , , ) para formatear nmeros.
• "ja-JP-u-ca-japanese": Use the Japanese calendar in date and time formatting, so that 2013 is expressed as the year 25 of the Heisei period, or 25.
• "en-GB-u-ca-islamic": use British English with the Islamic (Hijri) calendar, where the Gregorian date 14 October, 2017 is the Hijri date 24 Muharram, 1439.

Locale negotiation

The locales argument, after stripping off all Unicode extensions, is interpreted as a prioritized request from the application. The runtime compares it against the locales it has available and picks the best one available. Two matching algorithms exist: the "lookup" matcher follows the Lookup algorithm specified in BCP 47; the "best fit" matcher lets the runtime provide a locale that's at least, but possibly more, suited for the request than the result of the Lookup algorithm. If the application doesn't provide a locales argument, or the runtime doesn't have a locale that matches the request, then the runtime's default locale is used. The matcher can be selected using a property of the options argument (see below).

If the selected language tag had a Unicode extension substring, that extension is now used to customize the constructed object or the behavior of the function. Each constructor or function supports only a subset of the keys defined for the Unicode extension, and the supported values often depend on the language tag. For example, the "co" key (collation) is only supported by Collator, and its "phonebk" value is only supported for German.

options argument

The options argument must be an object with properties that vary between constructors and functions. If the options argument is not provided or is undefined, default values are used for all properties.

One property is supported by all language sensitive constructors and functions: The localeMatcher property, whose value must be a string "lookup" or "best fit" and which selects one of the locale matching algorithms described above.

Especificaciones

Specification
ECMAScript 2027 Internationalization API Specification # intl-object

Compatibilidad con navegadores

See also

• Introduction: The ECMAScript Internationalization API

• Constructors

  • Intl.Collator
  • Intl.DateTimeFormat
  • Intl.NumberFormat

• Methods

  • String.prototype.localeCompare()
  • Number.prototype.toLocaleString()
  • Date.prototype.toLocaleString()
  • Date.prototype.toLocaleDateString()
  • Date.prototype.toLocaleTimeString()