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 <alexander_belial999@hotmail.com>

2 files changed, 135 insertions, 189 deletions

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
----
-<div>{{JSRef("Global_Objects", "NumberFormat", "Intl,Collator,DateTimeFormat")}}</div>
-
-<h2 id="Resumen">Resumen</h2>
-
-<p>El objeto <strong><code>Intl.NumberFormat</code></strong> es un constructor para objetos que permiten un formato numérico sensible al idioma.</p>
-
-<h2 id="Sintaxis">Sintaxis</h2>
-
-<pre class="syntaxbox">new Intl.NumberFormat([locales [, <em>options</em>]])
-
-Intl.<code>NumberFormat</code>.call(<em>this</em> [, locales [, <em>options</em>]])</pre>
-
-<h3 id="Parámetros">Parámetros</h3>
-
-<dl>
- <dt><code>locales</code></dt>
- <dd>
- <p>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 <code>locales</code>, visite el siguiente enlace: <a href="/en-US/docs/JavaScript/Reference/Global_Objects/Intl#Locale_identification_and_negotiation" title="/Intl#Functionality_common_to_internationalization_constructors">página de Intl</a>. Se admite la siguiente clave de extension Unicode:</p>
-
- <dl>
-  <dt>nu</dt>
-  <dd>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".</dd>
- </dl>
- </dd>
- <dt><code>options</code></dt>
- <dd>
- <p>Objeto con alguna o todas las propiedas listadas a continuación:</p>
-
- <dl>
-  <dt><code>localeMatcher</code></dt>
-  <dd>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: <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl#Locale_negotiation" title="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl#Locale_negotiation">página de Intl</a>.</dd>
-  <dt><code>style</code></dt>
-  <dd>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".</dd>
-  <dt><code>currency</code></dt>
-  <dd>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: l<a href="http://www.currency-iso.org/en/home/tables/table-a1.html">ista actual de códigos de divisa y fondos</a>. No existe un valor por defecto, por lo que si es valor del parámetro <code>style</code> es "currency", deberá proveerse también un valor para la propiedad <code>currency</code>.</dd>
-  <dt><code>currencyDisplay</code></dt>
-  <dd>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".</dd>
-  <dt><code>useGrouping</code></dt>
-  <dd>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 <code>true</code> y <code>false</code>; el valor por defecto es <code>true</code>.</dd>
- </dl>
-
- <p>Las propiedades descritas a continuación se dividen en dos grupos: por un lado <code>minimumIntegerDigits</code>, <code>minimumFractionDigits</code> y <code>maximumFractionDigits</code>, por el otro <code>minimumSignificantDigits</code> y <code>maximumSignificantDigits</code>. Si al menos una propiedad del segundo grupo es definida, todas aquellas del primero serán ignoradas.</p>
-
- <dl>
-  <dt><code>minimumIntegerDigits</code></dt>
-  <dd>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.</dd>
-  <dt><code>minimumFractionDigits</code></dt>
-  <dd>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 <a href="http://www.currency-iso.org/en/home/tables/table-a1.html">lista de códigos de moneda ISO 4217</a> para subdivisiones de tal divisa (o 2 si la lista no establece un valor).</dd>
-  <dt><code>maximumFractionDigits</code></dt>
-  <dd>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 <code>minimumFractionDigits</code> y 3; el valor por defecto para el formato de moneda es el valor más alto admisible en <code>minimumFractionDigits</code> y el indicado en la <a href="http://www.currency-iso.org/en/home/tables/table-a1.html">lista de cógidos de moneda ISO 4217</a> 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 <code>minimumFractionDigits</code> y 0.</dd>
-  <dt><code>minimumSignificantDigits</code></dt>
-  <dd>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.</dd>
-  <dt><code>maximumSignificantDigits</code></dt>
-  <dd>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 <code>minimumSignificantDigits</code>.</dd>
- </dl>
- </dd>
-</dl>
-
-<h2 id="Description" name="Description">Descripción</h2>
-
-<h3 id="Properties" name="Properties">Propiedades</h3>
-
-<dl>
- <dt>{{jsxref("NumberFormat.prototype", "Intl.NumberFormat.prototype")}}</dt>
- <dd>Permite agregar nuevas propiedades a todos los objetos.</dd>
-</dl>
-
-<h3 id="Métodos">Métodos</h3>
-
-<dl>
- <dt>{{jsxref("NumberFormat.supportedLocalesOf", "Intl.NumberFormat.supportedLocalesOf()")}}</dt>
- <dd>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.</dd>
-</dl>
-
-<h2 id="Instancias_NumberFormat">Instancias <code>NumberFormat</code></h2>
-
-<h3 id="Propiedades">Propiedades</h3>
-
-<p>Toda instancia de <code>NumberFormat</code> hereda las siguientes propiedades de su prototipo:</p>
-
-<div>{{page('en-US/docs/JavaScript/Reference/Global_Objects/NumberFormat/prototype','Properties')}}</div>
-
-<h3 id="Métodos_2">Métodos</h3>
-
-<div>
-<p>Toda instancia de <code>NumberFormat </code>hereda los siguientes métodos de su prototipo:</p>
-{{page('en-US/docs/JavaScript/Reference/Global_Objects/NumberFormat/prototype','Methods')}}</div>
-
-<h2 id="Ejemplos">Ejemplos</h2>
-
-<p>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.</p>
-
-<pre class="brush: js">var number = 3500;
-
-alert(new Intl.NumberFormat().format(number));
-// → "3,500" si el código de idioma es US English
-</pre>
-
-<h3 id="Example_Using_locales" name="Example:_Using_locales">Ejemplo: Utilizando <code>locales</code></h3>
-
-<p>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 <code>locales</code>:</p>
-
-<pre class="brush: js">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
-</pre>
-
-<h3 id="Example_Using_options" name="Example:_Using_options">Ejemplo: Utilizando <code>options</code></h3>
-
-<p>El valor que regresa la función <code>toLocaleString</code> puede ser modificado utilizando el argumento <code>options</code>:</p>
-
-<pre class="brush: js">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
-</pre>
-
-<h2 id="Especificaciones">Especificaciones</h2>
-
-<table class="standard-table">
- <tbody>
-  <tr>
-   <th scope="col">Especificación</th>
-   <th scope="col">Estado actual</th>
-   <th scope="col">Comentario</th>
-  </tr>
-  <tr>
-   <td>{{SpecName('ES Int 1.0', '#sec-11.1', 'Intl.NumberFormat')}}</td>
-   <td>{{Spec2('ES Int 1.0')}}</td>
-   <td>Definición inicial</td>
-  </tr>
-  <tr>
-   <td>{{SpecName('ES Int 2.0', '#sec-11.1', 'Intl.NumberFormat')}}</td>
-   <td>{{Spec2('ES Int 2.0')}}</td>
-   <td></td>
-  </tr>
-  <tr>
-   <td>{{SpecName('ES Int Draft', '#numberformat-objects', 'Intl.NumberFormat')}}</td>
-   <td>{{Spec2('ES Int Draft')}}</td>
-   <td></td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Compatibilidad_de_los_navegadores">Compatibilidad de los navegadores</h2>
-
-<div>
-
-
-<p>{{Compat("javascript.builtins.Intl.NumberFormat")}}</p>
-</div>
-
-<h2 id="Vea_también">Vea también</h2>
-
-<p>{{page('en-US/docs/JavaScript/Reference/Global_Objects/Intl','See_also')}}</p>
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")}}
+
+<!-- The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request. -->
+
+## 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")}}
+