From 6ae720977c9b08e0bf4d551629a5f94989e86be5 Mon Sep 17 00:00:00 2001 From: Juan Vásquez Date: Tue, 22 Feb 2022 12:01:45 -0600 Subject: 7. Update numberformat [es] (#4179) * 7. web/javascript/reference/global_objects/intl/numberformat/index.html [ES] - [x] Change from HTML to MD format - [x] Sync content Closes #4154 * Apply suggestions from code review Co-authored-by: Anderson Vallejo <48649209+Vallejoanderson@users.noreply.github.com> Co-authored-by: Alexander --- .../global_objects/intl/numberformat/index.html | 189 --------------------- .../global_objects/intl/numberformat/index.md | 135 +++++++++++++++ 2 files changed, 135 insertions(+), 189 deletions(-) delete mode 100644 files/es/web/javascript/reference/global_objects/intl/numberformat/index.html create mode 100644 files/es/web/javascript/reference/global_objects/intl/numberformat/index.md (limited to 'files/es/web/javascript/reference/global_objects/intl/numberformat') diff --git a/files/es/web/javascript/reference/global_objects/intl/numberformat/index.html b/files/es/web/javascript/reference/global_objects/intl/numberformat/index.html deleted file mode 100644 index 390a525699..0000000000 --- a/files/es/web/javascript/reference/global_objects/intl/numberformat/index.html +++ /dev/null @@ -1,189 +0,0 @@ ---- -title: Intl.NumberFormat -slug: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat -translation_of: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat -original_slug: Web/JavaScript/Referencia/Objetos_globales/Intl/NumberFormat ---- -
{{JSRef("Global_Objects", "NumberFormat", "Intl,Collator,DateTimeFormat")}}
- -

Resumen

- -

El objeto Intl.NumberFormat es un constructor para objetos que permiten un formato numérico sensible al idioma.

- -

Sintaxis

- -
new Intl.NumberFormat([locales [, options]])
-
-Intl.NumberFormat.call(this [, locales [, options]])
- -

Parámetros

- -
-
locales
-
-

Cadena o arreglo de cadenas identificadoras para el código de idioma, conforme a BCP 47. Para mayor información con respecto a la forma e interpretación del argumento locales, visite el siguiente enlace: página de Intl. Se admite la siguiente clave de extension Unicode:

- -
-
nu
-
El sistema numérico a ser utilizado. Los siguientes son valores admisibles: "arab", "arabext", "bali", "beng", "deva", "fullwide", "gujr", "guru", "hanidec", "khmr", "knda", "laoo", "latn", "limb", "mlym", "mong", "mymr", "orya", "tamldec", "telu", "thai", "tibt".
-
-
-
options
-
-

Objeto con alguna o todas las propiedas listadas a continuación:

- -
-
localeMatcher
-
Algoritmo a emplear para establecer el idioma. Los valores admitidos son "lookup" (coincidencia exacta) y "best fit" (mejor coincidencia); el valor por defecto es "best fit". Para mayor información respecto a esta opción visite el siguiente enlace: página de Intl.
-
style
-
El estilo de formato a utilizar. Los valores admisibles son "decimal" para un formato numérico simple, "currency" para un formato de divisa, y "percent" para un formato porcentual; el valor por defecto es "decimal".
-
currency
-
La divisa a utilizar para el formato de divisa. Los valores admisibles son los establecidos en ISO 4217, por ejemplo "USD" para el dólar americano, "EUR" para el euro, o "CNY" para el RMB chino - para mayor información se recomienda visitar el siguiente enlace: lista actual de códigos de divisa y fondos. No existe un valor por defecto, por lo que si es valor del parámetro style es "currency", deberá proveerse también un valor para la propiedad currency.
-
currencyDisplay
-
Descriptor a utilizar para denotar el valor expresado como divisa. Los valores admisibles son "symbol" para utilizar el símbolo local a su contexto, por ejemplo €, "code" para utilizar el código de divisa ISO, "name" para utilizar el nombre local de la divisa, por ejemplo "dollar"; el valor por defecto es "symbol".
-
useGrouping
-
Si deberán emplearse o no separadores para agrupamiento, como es el caso de los separadores para millares o separadores millares/lakh/crore. Los valores admisibles son true y false; el valor por defecto es true.
-
- -

Las propiedades descritas a continuación se dividen en dos grupos: por un lado minimumIntegerDigits, minimumFractionDigits y maximumFractionDigits, por el otro minimumSignificantDigits y maximumSignificantDigits. Si al menos una propiedad del segundo grupo es definida, todas aquellas del primero serán ignoradas.

- -
-
minimumIntegerDigits
-
El número mínimo de digitos enteros a utilizar. El rango de valores admisibles va desde 1 hasta 21; el valor por defecto es 1.
-
minimumFractionDigits
-
El número mínimo de digitos fraccionarios a utilizar. El rango de valores admisibles va desde 0 hasta 20; el valor por defecto para formato simple y porcentual es 0; el valor por defecto para formato de divisa es el indicado en la lista de códigos de moneda ISO 4217 para subdivisiones de tal divisa (o 2 si la lista no establece un valor).
-
maximumFractionDigits
-
El número máximo de dígitos de fraccionarios a utilizar. El rango de valores admisibles va desde 0 hasta 20; el valor por defecto para formato simple es el valor más alto admisible en minimumFractionDigits y 3; el valor por defecto para el formato de moneda es el valor más alto admisible en minimumFractionDigits y el indicado en la lista de cógidos de moneda ISO 4217 para subdivisiones de tal divisa (o 2 si la lista no establece un valor); el valor por defecto en el formato porcentual es el valor más alto admisible en minimumFractionDigits y 0.
-
minimumSignificantDigits
-
El número mínimo de dígitos significativos a utilizar. El rango de valores admisibles va desde 1 hasta 21; el valor por defecto es 1.
-
maximumSignificantDigits
-
El número máximo de dígitos significativos a utilizar. El rango de valores admisibles va desde 1 hasta 21; el valor por defecto es minimumSignificantDigits.
-
-
-
- -

Descripción

- -

Propiedades

- -
-
{{jsxref("NumberFormat.prototype", "Intl.NumberFormat.prototype")}}
-
Permite agregar nuevas propiedades a todos los objetos.
-
- -

Métodos

- -
-
{{jsxref("NumberFormat.supportedLocalesOf", "Intl.NumberFormat.supportedLocalesOf()")}}
-
Regresa un arreglo con aquellos códigos de idioma proveídos y que son soportados sin necesidad de recurrir a la configuración por defecto en el entorno de ejecucion.
-
- -

Instancias NumberFormat

- -

Propiedades

- -

Toda instancia de NumberFormat hereda las siguientes propiedades de su prototipo:

- -
{{page('en-US/docs/JavaScript/Reference/Global_Objects/NumberFormat/prototype','Properties')}}
- -

Métodos

- -
-

Toda instancia de NumberFormat hereda los siguientes métodos de su prototipo:

-{{page('en-US/docs/JavaScript/Reference/Global_Objects/NumberFormat/prototype','Methods')}}
- -

Ejemplos

- -

Al no especificar un código de idioma, se regresa una cadena con el formato correspondiente al código de idioma y opciones disponibles por defecto en el entorno de ejecución.

- -
var number = 3500;
-
-alert(new Intl.NumberFormat().format(number));
-// → "3,500" si el código de idioma es US English
-
- -

Ejemplo: Utilizando locales

- -

Este ejemplo muestra algunas de las variantes en formato numérico con diferentes contextos locales. A fin de emplear el idioma correspondiente a aquél en la interfaz del usuario para su aplicación, asegúrese de especificar dicho idioma ( y de ser posible alternativas) utilizando el argumento locales:

- -
var number = 123456.789;
-
-// En el alemán la coma se utiliza como separador decimal y el punto para los millares
-alert(new Intl.NumberFormat("de-DE").format(number));
-// → 123.456,789
-
-// En la mayoría de los países de lengua arábiga se utilizan también símbolos arábigos
-alert(new Intl.NumberFormat("ar-EG").format(number));
-// → ١٢٣٤٥٦٫٧٨٩
-
-// En la India se utilizan separadores millares/lakh/crore
-alert(new Intl.NumberFormat("en-IN").format(number));
-// → 1,23,456.789
-
-// use de nu para establecer un sistema numérico, el sistema decimal chino por ejemplo
-alert(new Intl.NumberFormat("zh-Hans-CN-u-nu-hanidec").format(number));
-// → 一二三,四五六.七八九
-
-// cuando se requiera un lenguaje que pudiera no ser soportado, como es el caso del Balinés
-// se recomienda incluir un lenguaje alternativo, en éste caso Indonesio
-alert(new Intl.NumberFormat(["ban", "id"]).format(number));
-// → 123.456,789
-
- -

Ejemplo: Utilizando options

- -

El valor que regresa la función toLocaleString puede ser modificado utilizando el argumento options:

- -
var number = 123456.789;
-
-// se establece un formato de divisa
-alert(new Intl.NumberFormat("de-DE", {style: "currency", currency: "EUR"}).format(number));
-// → 123.456,79 €
-
-// el yen japonés no tiene ninguna subdivisión
-alert(new Intl.NumberFormat("ja-JP", {style: "currency", currency: "JPY"}).format(number))
-// → ￥123,457
-
-// limitamos a tres los dígitos significativos
-alert(new Intl.NumberFormat("en-IN", {maximumSignificantDigits: 3}).format(number));
-// → 1,23,000
-
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - - - - - - -
EspecificaciónEstado actualComentario
{{SpecName('ES Int 1.0', '#sec-11.1', 'Intl.NumberFormat')}}{{Spec2('ES Int 1.0')}}Definición inicial
{{SpecName('ES Int 2.0', '#sec-11.1', 'Intl.NumberFormat')}}{{Spec2('ES Int 2.0')}}
{{SpecName('ES Int Draft', '#numberformat-objects', 'Intl.NumberFormat')}}{{Spec2('ES Int Draft')}}
- -

Compatibilidad de los navegadores

- -
- - -

{{Compat("javascript.builtins.Intl.NumberFormat")}}

-
- -

Vea también

- -

{{page('en-US/docs/JavaScript/Reference/Global_Objects/Intl','See_also')}}

diff --git a/files/es/web/javascript/reference/global_objects/intl/numberformat/index.md b/files/es/web/javascript/reference/global_objects/intl/numberformat/index.md new file mode 100644 index 0000000000..3bce2ca064 --- /dev/null +++ b/files/es/web/javascript/reference/global_objects/intl/numberformat/index.md @@ -0,0 +1,135 @@ +--- +title: Intl.NumberFormat +slug: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat +original_slug: Web/JavaScript/Referencia/Objetos_globales/Intl/NumberFormat +browser-compat: javascript.builtins.Intl.NumberFormat +--- +{{JSRef}} + +El objecto **`Intl.NumberFormat`** habilita el formato numérico de acuerdo al lenguaje. + +{{EmbedInteractiveExample("pages/js/intl-numberformat.html")}} + + + +## Constructor + +- {{jsxref("Intl/NumberFormat/NumberFormat", "Intl.NumberFormat()")}} + - : Crea un nuevo objecto `NumberFormat`. + +## Métodos estaticos + +- {{jsxref("Intl/NumberFormat/supportedLocalesOf", "Intl.NumberFormat.supportedLocalesOf()")}} + - : Regresa un arreglo con idiomas soportados sin necesidad de recurrir a la configuración por defecto en el entorno de ejecución. + +## Métodos de instancia + +- {{jsxref("Intl/NumberFormat/format", "Intl.NumberFormat.prototype.format()")}} + - : Función de acceso que formatea un número de acuerdo al lenguaje y a las opciones de formato de este objeto {{jsxref("Intl.NumberFormat")}}. +- {{jsxref("Intl/NumberFormat/formatToParts", "Intl.NumberFormat.prototype.formatToParts()")}} + - : Devuelve un {{jsxref("Array")}} de objetos que representan la cadena de números en partes que se pueden usar para el formato personalizado que reconoce la configuración regional. +- {{jsxref("Intl/NumberFormat/formatRange", "Intl.NumberFormat.prototype.formatRange()")}} + - : Función de acceso que formatea un rango de números de acuerdo a la configuración region y a las opciones de formato del objeto {{jsxref("Intl.NumberFormat")}} desde el que se llama al método. +- {{jsxref("Intl/NumberFormat/formatRangeToParts", "Intl.NumberFormat.prototype.formatRangeToParts()")}} + - : Devuelve un {{jsxref("Array")}} de objetos que representan el rango de cadenas de números en partes que se pueden usar para el formato personalizado que reconoce la configuración regional. +- {{jsxref("Intl/NumberFormat/resolvedOptions", "Intl.NumberFormat.prototype.resolvedOptions()")}} + - : Devuelve un nuevo objeto con propiedades que reflejan la configuración regional y las opciones de intercalación calculadas durante la inicialización del objeto. + +## Ejemplo + +### Uso básico + +En el uso básico sin especificar una configuración regional, se devuelve una cadena formateada en la configuración regional predeterminada y con opciones predeterminadas. + +```js +var number = 3500; + +console.log(new Intl.NumberFormat().format(number)); +// → '3,500' si está en la region de Estados Unidos +``` + +### Utilizando la configuración regional + + +Este ejemplo muestra algunas de las variaciones en los formatos de números por región. +Para obtener el formato del idioma usado en la interfaz de usuario de tu aplicación, asegúrate de especificar dicho idioma (y de ser posible alternativas) utilizando el argumento `locales`: + +```js +var number = 123456.789; + +// En el alemán la coma se utiliza como separador decimal y el punto para los millares +console.log(new Intl.NumberFormat('de-DE').format(number)); +// → 123.456,789 + +// En la mayoría de los países de lengua arábiga se utilizan también símbolos arábigos +console.log(new Intl.NumberFormat('ar-EG').format(number)); +// → ١٢٣٤٥٦٫٧٨٩ + +// En la India se utilizan separadores millares/lakh/crore +console.log(new Intl.NumberFormat('en-IN').format(number)); +// → 1,23,456.789 + +// La clave de extensión nu requiere un sistema de numeración, p.ej. el decimal chino +console.log(new Intl.NumberFormat('zh-Hans-CN-u-nu-hanidec').format(number)); +// → 一二三,四五六.七八九 + +// Cuando se requiera un lenguaje que pudiera no ser soportado, como es el caso del Balinés +// se recomienda incluir un lenguaje alternativo, en éste caso Indonesio +console.log(new Intl.NumberFormat(['ban', 'id']).format(number)); +// → 123.456,789 +``` + +### Usando opciones + +Los resultados se pueden personalizar usando el argumento `opciones`: + +```js +var number = 123456.789; + +// Se establece un formato de divisa +console.log(new Intl.NumberFormat('de-DE', { style: 'currency', currency: 'EUR' }).format(number)); +// → 123.456,79 € + +// El yen japonés no tiene ninguna unidad menor +console.log(new Intl.NumberFormat('ja-JP', { style: 'currency', currency: 'JPY' }).format(number)); +// → ￥123,457 + +// Limitamos a tres los dígitos significativos +console.log(new Intl.NumberFormat('en-IN', { maximumSignificantDigits: 3 }).format(number)); +// → 1,23,000 +``` + +### Usando estilos y unidades + +```js +console.log(new Intl.NumberFormat('pt-PT',  { +    style: 'unit', +    unit: 'kilometer-per-hour' +}).format(50)); +// → 50 km/h + +console.log((16).toLocaleString('en-GB', { +    style: 'unit', +    unit: 'liter', +    unitDisplay: 'long' +})); +// → 16 litros +``` + +## [Polyfill](/es/docs/Glossary/Polyfill) + +[formatjs Intl.NumberFormat polyfill](https://formatjs.io/docs/polyfills/intl-numberformat) + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} + +## Véase también + +- {{jsxref("Intl")}} + -- cgit v1.2.3-54-g00ecf