los toLocaleTimeString() el método devuelve un string con una representación sensible al idioma de la parte de tiempo de esta fecha. El nuevo locales y options Los argumentos permiten a las aplicaciones especificar el lenguaje cuyas convenciones de formato deben usarse y personalizar el comportamiento de la función. En implementaciones más antiguas, que ignoran la locales y options argumentos, la configuración regional utilizada y la forma de la string devueltos dependen totalmente de la implementación.

Sintaxis

toLocaleTimeString()toLocaleTimeString(locales)toLocaleTimeString(locales, options)

Parámetros

los locales y options Los argumentos personalizan el comportamiento de la función y permiten que las aplicaciones especifiquen el lenguaje cuyas convenciones de formato deben usarse. En implementaciones, que ignoran la locales y options argumentos, la configuración regional utilizada y la forma de la string devueltos dependen totalmente de la implementación.

Ver el Intl.DateTimeFormat() constructor para obtener detalles sobre estos parámetros y cómo usarlos.

El valor predeterminado para cada propiedad del componente de fecha y hora es undefined, pero si el hour, minute, second las propiedades son todas undefined, luego hour, minute, y second se supone que son "numeric".

Valor devuelto

A string que representa la porción de tiempo del dado Date instancia de acuerdo con las convenciones específicas del idioma.

Rendimiento

Al formatear un gran número de fechas, es mejor crear un Intl.DateTimeFormat objeto y utilizar la función proporcionada por su format propiedad.

Ejemplos de

Usando toLocaleTimeString ()

En uso básico sin especificar una configuración regional, un formato string en la configuración regional predeterminada y con las opciones predeterminadas se devuelve.

var date =newDate(Date.UTC(2012,11,12,3,0,0));// toLocaleTimeString() without arguments depends on the implementation,// the default locale, and the default time zone
console.log(date.toLocaleTimeString());// → "7:00:00 PM" if run in en-US locale with time zone America/Los_Angeles

Comprobando soporte para configuraciones regionales y argumentos de opciones

los locales y options Los argumentos aún no son compatibles con todos los navegadores. Para comprobar si una implementación ya los admite, puede utilizar el requisito de que las etiquetas de idiomas ilegales se rechacen con un RangeError excepción:

functiontoLocaleTimeStringSupportsLocales()trynewDate().toLocaleTimeString('i');catch(e)return e.name ==='RangeError';returnfalse;

Usando locales

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

var date =newDate(Date.UTC(2012,11,20,3,0,0));// formats below assume the local time zone of the locale;// America/Los_Angeles for the US// US English uses 12-hour time with AM/PM
console.log(date.toLocaleTimeString('en-US'));// → "7:00:00 PM"// British English uses 24-hour time without AM/PM
console.log(date.toLocaleTimeString('en-GB'));// → "03:00:00"// Korean uses 12-hour time with AM/PM
console.log(date.toLocaleTimeString('ko-KR'));// → "오후 12:00:00"// Arabic in most Arabic speaking countries uses real Arabic digits
console.log(date.toLocaleTimeString('ar-EG'));// → "٧:٠٠:٠٠ م"// when requesting a language that may not be supported, such as// Balinese, include a fallback language, in this case Indonesian
console.log(date.toLocaleTimeString(['ban','id']));// → "11.00.00"

Usar opciones

Los resultados proporcionados por toLocaleTimeString() se puede personalizar con el options argumento:

var date =newDate(Date.UTC(2012,11,20,3,0,0));// an application may want to use UTC and make that visiblevar options = timeZone:'UTC', timeZoneName:'short';
console.log(date.toLocaleTimeString('en-US', options));// → "3:00:00 AM GMT"// sometimes even the US needs 24-hour time
console.log(date.toLocaleTimeString('en-US', hour12:false));// → "19:00:00"// show only hours and minutes, use options with the default locale - use an empty array
console.log(date.toLocaleTimeString([], hour:'2-digit', minute:'2-digit'));// → "20:01"

Especificaciones

Especificación
Especificación del lenguaje ECMAScript (ECMAScript)
# sec-date.prototype.tolocaletimestring
Especificación de la API de internacionalización de ECMAScript (API de internacionalización de ECMAScript)
# sup-date.prototype.tolocaletimestring

Compatibilidad del navegador

Escritorio Móvil
Cromo Borde Firefox explorador de Internet Ópera Safari WebView Android Chrome Android Firefox para Android Opera Android Safari en IOS Internet de Samsung
toLocaleTimeString 1 12 1 5.5 5 1 1 18 4 10.1 1 1.0
iana_time_zone_names 24 14 52 No 15 6.1 4.4 25 56 14 7 1,5
locales 24 12 29 11 15 10 4.4 25 56 14 10 1,5
options 24 12 29 11 15 10 4.4 25 56 14 10 1,5

Ver también

  • Intl.DateTimeFormat
  • Date.prototype.toLocaleDateString()
  • Date.prototype.toLocaleString()
  • Date.prototype.toTimeString()
  • Date.prototype.toString()