CKTIS / JavaScript
Date.prototype.toLocaleTimeString() — formato de hora localizado
toLocaleTimeString() devuelve una representación textual de la hora de un objeto Date según la configuración regional y las opciones seleccionadas. Permite elegir la zona horaria, los componentes de la hora y el ciclo horario sin modificar la fecha.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
date.toLocaleTimeString(locales?, options?)El símbolo del catálogo Date.toLocaleTimeString se refiere al método de instancia Date.prototype.toLocaleTimeString, no a un método estático del constructor Date. La llamada date.toLocaleTimeString(locales, options) devuelve una cadena sin modificar date. El comportamiento de los parámetros descrito aquí se aplica a entornos compatibles con ECMA-402 (Intl).
locales acepta una etiqueta de idioma, como pl-PL, o una lista de etiquetas preferidas. Si se omite, se usa la configuración regional predeterminada del entorno. options.timeZone elige la zona horaria de presentación; de lo contrario, se usa la zona del entorno. Las opciones hour, minute y second seleccionan los componentes de la hora. Si no se especifica hour12, hourCycle: 'h23' establece horas de 0 a 23. La opción hour12 tiene prioridad sobre hourCycle: si se especifican a la vez hour12: true y hourCycle: 'h23', se usa un ciclo de 12 horas. Si no se indica un estilo ni componentes horarios, se incluyen por defecto la hora, los minutos y los segundos.
Se puede usar timeStyle, por ejemplo 'short', en lugar de opciones explícitas para los componentes. Al formatear una fecha válida, combinar timeStyle con una opción de componente como hour provoca un TypeError. Para una fecha válida, pasar dateStyle a toLocaleTimeString() también provoca un TypeError, aunque sea la única opción. Si el objeto Date no es válido, el método devuelve "Invalid Date" antes de procesar las opciones, por lo que combinar timeStyle con hour no provoca un error en ese caso. Un receptor que no sea un objeto Date provoca un TypeError.
El resultado está pensado para mostrarse al usuario, no para almacenarse en un formato estable ni para analizarse: los datos de configuración regional pueden cambiar la puntuación y los espacios. El ejemplo fija el instante, la configuración regional, la zona UTC, el ciclo horario y el sistema de numeración para reducir las variaciones. Si se formatea repetidamente, conviene crear un Intl.DateTimeFormat y reutilizar su método format.
Ejemplos
const date = new Date('2024-01-15T13:05:09.000Z');
const text = date.toLocaleTimeString('en-GB', {
timeZone: 'UTC',
hourCycle: 'h23',
numberingSystem: 'latn',
hour: '2-digit',
minute: '2-digit',
second: '2-digit'
});
console.log(text);Resultado
13:05:09
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.