From 35c6237c06506e2c539fbb7b90fb75258e32c870 Mon Sep 17 00:00:00 2001 From: Pedro Torcatt Date: Wed, 2 Mar 2022 09:52:20 -0400 Subject: Translate and rename index.html to index.md (#4321) * Translate and rename index.html to index.md Closes #4319 * Cambios recomendados --- .../date/tolocaledatestring/index.html | 160 --------------------- .../date/tolocaledatestring/index.md | 154 ++++++++++++++++++++ 2 files changed, 154 insertions(+), 160 deletions(-) delete mode 100644 files/es/web/javascript/reference/global_objects/date/tolocaledatestring/index.html create mode 100644 files/es/web/javascript/reference/global_objects/date/tolocaledatestring/index.md (limited to 'files/es/web/javascript') diff --git a/files/es/web/javascript/reference/global_objects/date/tolocaledatestring/index.html b/files/es/web/javascript/reference/global_objects/date/tolocaledatestring/index.html deleted file mode 100644 index 35cd7d54b6..0000000000 --- a/files/es/web/javascript/reference/global_objects/date/tolocaledatestring/index.html +++ /dev/null @@ -1,160 +0,0 @@ ---- -title: Date.prototype.toLocaleDateString() -slug: Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString -tags: - - Fecha - - IANA formato horario - - Internacionalizacion - - JavaScript - - Prototipo - - Prototype - - Referencia - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString -original_slug: Web/JavaScript/Referencia/Objetos_globales/Date/toLocaleDateString ---- -
{{JSRef}}
- -

El método toLocaleDateString() devuelve una cadena con una representación de la fecha sensible al lenguaje. Los nuevos argumentos locales y options permiten a las aplicaciones especificar el lenguaje cuyas convenciones de formato deben usarse y permitir personalizar el comportamiento de la función. En implementaciones anteriores, las cuales ignoran los argumentos locales y options, el configuración regional usada y el formato de cadena devuelto dependen completamente de la implementación.

- -
{{EmbedInteractiveExample("pages/js/date-tolocaledatestring.html")}}
- - - -

Sintaxis

- -
dateObj.toLocaleDateString([locales [, options]])
- -

Parámetros

- -

Compruebe la sección de Compatibilidad con su navegador para ver qué navegadores suportan los argumentos locales y options, y el Ejemplo: Comprobando el soporte para los argumentos locales y options para detectar dicha característica.

- -
{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat', 'Parameters')}}
- -

El valor por defecto para cada propiedad del componente date-time es {{jsxref("undefined")}}, pero si las propiedades weekday, year, month, day son todas {{jsxref("undefined")}}, entonces year, month, y day se asumen tener el valor "numeric".

- -

Valor devuelto

- -

Una cadena representando una porción de fecha de la instancia {{jsxref("Global_Objects/Date", "Date")}} indicada de acuerdo con las convenciones específicas del lenguaje.

- -

Ejemplos

- -

Usando toLocaleDateString()

- -

En un caso básico sin especificar una configuración regional, se devolverá una cadena formateada en la configuración regional y las opciones por defecto.

- -
var date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0));
-
-// toLocaleDateString() sin argumentos dependientes de la implementación,
-// de la configuración regional por defecto y la zona horaria por defecto
-console.log(date.toLocaleDateString());
-// → "12/11/2012" si se ejecuta en una configuración regional en-US con zona horaria America/Los_Angeles
-
- -

Comprobando el soporte para los argumentos locales y options

- -

Los argumentos locales y options no son soportados aún por todos los navegadores. Para comprobar si una implementación los soporta, puede usar el requerimiento To check whether an implementation supports them already, you can use the requirement that illegal language tags are rejected with a {{jsxref("RangeError")}} exception:

- -
function toLocaleDateStringSupportsLocales() {
-  try {
-    new Date().toLocaleDateString('i');
-  } catch (e) {
-    return e.name === 'RangeError';
-  }
-  return false;
-}
-
-Using locales
- -

Usando locales

- -

Este ejemplo muestra algunas de las variaciones en los formatos de configuración regional de las fechas. Para poder obtener el formato del idioma usado en la interfaz de usuario de su aplicación, asegúrese de especificar el idioma (y posiblemente algunos idiomas alternativos) usando el argumento locales:

- -
var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
-
-// Los formatos de abajo asumen la zona horaria local de la configuración regional;
-// America/Los_Angeles para US
-
-// El inglés de USA hace uso de orden mes-día-año
-console.log(date.toLocaleDateString('en-US'));
-// → "12/19/2012"
-
-// El inglés británico hace uso del orden día-mes-año
-console.log(date.toLocaleDateString('en-GB'));
-// → "20/12/2012"
-
-// El coreano hace uso del orden año-mes-día
-console.log(date.toLocaleDateString('ko-KR'));
-// → "2012. 12. 20."
-
-// Evento para persa. Es difícil convertir manualmente la fecha a Solar Hijri
-console.log(date.toLocaleDateString('fa-IR'));
-// → "۱۳۹۱/۹/۳۰"
-
-// El árave en la mayoría de paises arabehablantes hace uso de los dígitos árabes
-console.log(date.toLocaleDateString('ar-EG'));
-// → "٢٠‏/١٢‏/٢٠١٢"
-
-// Para el japonés, las aplicaciones quieren poder usar el calendario japonés,
-// donde 2012 era el año 24 de la era Heisei
-console.log(date.toLocaleDateString('ja-JP-u-ca-japanese'));
-// → "24/12/20"
-
-// Cuando solicite un idioma que no esté soportado, por ejemplo el balinés,
-// incluya un idioma alternativo, en este caso el indonesio
-console.log(date.toLocaleDateString(['ban', 'id']));
-// → "20/12/2012"
-
- -

Usando options

- -

Los resultados aportados por toLocaleDateString() pueden ser personalizados usando el argumento options:

- -
var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
-
-// Solicita el día de la semana junto a una fecha larga
-var options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' };
-console.log(date.toLocaleDateString('de-DE', options));
-// → "Donnerstag, 20. Dezember 2012"
-
-// Una aplicación puede querer usar UTC y hacer que sea visible
-options.timeZone = 'UTC';
-options.timeZoneName = 'short';
-console.log(date.toLocaleDateString('en-US', options));
-// → "Thursday, December 20, 2012, GMT"
-
- -

Performance

- -

Cuando se formatea números largos de fechas, es mejor crear un objeto {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}} y usar la función aportada por esta propiedad {{jsxref("DateTimeFormat.prototype.format", "format")}}.

- -

Especificaciones

- - - - - - - - - - - - - -
Especificación
{{SpecName('ESDraft', '#sec-date.prototype.tolocaledatestring', 'Date.prototype.toLocaleDateString')}}
{{SpecName('ES Int Draft', '#sup-date.prototype.tolocaledatestring', 'Date.prototype.toLocaleDateString')}}
- -

Compatibilidad con el navegador

- - - -

{{Compat("javascript.builtins.Date.toLocaleDateString")}}

- -

Véase también

- - diff --git a/files/es/web/javascript/reference/global_objects/date/tolocaledatestring/index.md b/files/es/web/javascript/reference/global_objects/date/tolocaledatestring/index.md new file mode 100644 index 0000000000..39c896f5f2 --- /dev/null +++ b/files/es/web/javascript/reference/global_objects/date/tolocaledatestring/index.md @@ -0,0 +1,154 @@ +--- +title: Date.prototype.toLocaleDateString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString +tags: + - Fecha + - Formato de zona horaria IANA + - Internacionalización + - JavaScript + - Método + - Prototipo + - Referencia +browser-compat: javascript.builtins.Date.toLocaleDateString +--- +{{JSRef}} + +El método **`toLocaleDateString()`** devuelve una cadena con una representación sensible al idioma de la parte de la fecha especificada en la zona horaria del agente de usuario. + +Los argumentos `locales` y `options` permiten a las aplicaciones especificar el idioma cuyas convenciones de formato deben utilizarse y permiten personalizar el comportamiento de la función. +En las implementaciones más antiguas, que ignoran los argumentos `locales` y `options`, la configuración regional utilizada y la forma de la cadena devuelta dependen totalmente de la implementación. + +{{EmbedInteractiveExample("pages/js/date-tolocaledatestring.html")}} + +## Sintaxis + +```js +toLocaleDateString() +toLocaleDateString(locales) +toLocaleDateString(locales, options) +``` + +### Parámetros + +Los argumentos `locales` y `options` personalizan el comportamiento de la función y permiten a las aplicaciones especificar el idioma cuyas convenciones de formato deben utilizarse. +En las implementaciones que ignoran los argumentos `locales` y `options`, la configuración regional utilizada y la forma de la cadena devuelta dependen totalmente de la implementación. + +Véase el constructor {{jsxref("Intl/DateTimeFormat/DateTimeFormat", "Intl.DateTimeFormat()")}} para obtener detalles sobre estos parámetros y cómo utilizarlos. + +El valor por defecto para cada propiedad del componente fecha-hora es {{jsxref("undefined")}}, pero si las propiedades `weekday`, `year`, `month`, `day` son todas {{jsxref("undefined")}}, entonces se asume que `year`, `month`, y `day` son `"numeric"`. + +### Valor de retorno + +Una cadena que representa la parte de la fecha de la instancia {{jsxref("Global_Objects/Date", "Date")}} dada según las convenciones específicas del idioma. + +## Rendimiento + +Cuando se formatea un gran número de fechas, es mejor crear un objeto {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}} y utilizar la función proporcionada por su propiedad {{jsxref("DateTimeFormat.prototype.format", "format")}}. + +## Ejemplos + +### Usando toLocaleDateString() + +En el uso básico sin especificar una configuración regional, se devuelve una cadena formateada en la configuración regional por defecto y con las opciones por defecto. + +```js +var date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0)); + +// toLocaleDateString() sin argumentos depende de la implementación, +// la configuración regional por defecto y la zona horaria por defecto +console.log(date.toLocaleDateString()); +// → "12/11/2012" si se ejecuta en la configuración regional en-US +// con la zona horaria America/Los_Angeles +``` + +### Comprobación de la compatibilidad con los argumentos locales y options + +Los argumentos `locales` y `options` aún no están soportados en todos los navegadores. +Para comprobar si una implementación ya los soporta, puede utilizar el requisito de que las etiquetas de idioma ilegales sean rechazadas con una excepción {{jsxref("RangeError")}}: + +```js +function toLocaleDateStringSupportsLocales() { + try { + new Date().toLocaleDateString('i'); + } catch (e) { + return e.name === 'RangeError'; + } + return false; +} +``` + +### Usando locales + +Este ejemplo muestra algunas de las variaciones en los formatos de fecha localizados. +Para obtener el formato del idioma utilizado en la interfaz de usuario de su aplicación, asegúrese de especificar ese idioma (y posiblemente algunos idiomas de reserva) utilizando el argumento `locales`: + +```js +var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); + +// Los formatos que aparecen a continuación asumen la zona horaria local de la localidad; +// América/Los_Angeles para los Estados Unidos + +// El inglés estadounidense utiliza el orden mes-día-año +console.log(date.toLocaleDateString('en-US')); +// → "12/20/2012" + +// El inglés británico utiliza el orden día-mes-año +console.log(date.toLocaleDateString('en-GB')); +// → "20/12/2012" + +// El coreano utiliza el orden año-mes-día +console.log(date.toLocaleDateString('ko-KR')); +// → "2012. 12. 20." + +// Evento para persas, es difícil convertir manualmente la fecha a Solar Hijri +console.log(date.toLocaleDateString('fa-IR')); +// → "۱۳۹۱/۹/۳۰" + +// En la mayoría de los países de habla árabe se utilizan dígitos árabes reales +console.log(date.toLocaleDateString('ar-EG')); +// → "٢٠‏/١٢‏/٢٠١٢" + +// para los japoneses, las aplicaciones pueden querer utilizar el calendario +// japonés, donde 2012 fue el año 24 de la era Heisei +console.log(date.toLocaleDateString('ja-JP-u-ca-japanese')); +// → "24/12/20" + +// cuando se solicita un idioma que puede no estar soportado +// como el balinés, incluir un idioma de reserva, en este caso el indonesio +console.log(date.toLocaleDateString(['ban', 'id'])); +// → "20/12/2012" +``` + +### Usando options + +Los resultados proporcionados por `toLocaleDateString()` pueden personalizarse utilizando el argumento `options`: + +```js +var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); + +// solicitar un día de la semana junto con una fecha larga +var options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' }; +console.log(date.toLocaleDateString('de-DE', options)); +// → "Donnerstag, 20. Dezember 2012" + +// una aplicación puede querer utilizar el UTC y hacerlo visible +options.timeZone = 'UTC'; +options.timeZoneName = 'short'; +console.log(date.toLocaleDateString('en-US', options)); +// → "Thursday, December 20, 2012, UTC" +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} + +## Véase también + +- {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}} +- {{jsxref("Date.prototype.toLocaleString()")}} +- {{jsxref("Date.prototype.toLocaleTimeString()")}} +- {{jsxref("Date.prototype.toString()")}} -- cgit v1.2.3-54-g00ecf