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
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()
Sección de Reseñas y Valoraciones
Si entiendes que te ha resultado de utilidad nuestro artículo, nos gustaría que lo compartas con más juniors de esta manera contrubuyes a extender nuestra información.