Date.prototype.toLocaleDateString()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
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.
Pruébalo
Sintaxis
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 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 undefined, pero si las propiedades weekday, year, month, day son todas 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 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 Intl.DateTimeFormat y utilizar la función proporcionada por su propiedad 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.
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 RangeError:
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:
Usando options
Los resultados proporcionados por toLocaleDateString() pueden personalizarse utilizando el argumento options:
Especificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.tolocaledatestring |
| ECMAScript® 2026 Internationalization API Specification # sup-date.prototype.tolocaledatestring |