CKTIS / JavaScript
Date.prototype.toLocaleTimeString() — formattazione localizzata dell’ora
toLocaleTimeString() restituisce una rappresentazione testuale dell’ora di un oggetto Date secondo la locale e le opzioni selezionate. Consente di scegliere il fuso orario, i componenti dell’ora e il ciclo orario senza modificare la data.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
date.toLocaleTimeString(locales?, options?)Il simbolo del catalogo Date.toLocaleTimeString indica il metodo di istanza Date.prototype.toLocaleTimeString, non un metodo statico del costruttore Date. La chiamata date.toLocaleTimeString(locales, options) restituisce una stringa senza modificare date. Il comportamento dei parametri descritto qui si applica agli ambienti che supportano ECMA-402 (Intl).
locales accetta un tag di lingua, ad esempio pl-PL, oppure un elenco di tag preferiti. Se viene omesso, si usa la locale predefinita dell’ambiente. options.timeZone seleziona il fuso orario di visualizzazione; altrimenti viene usato quello dell’ambiente. Le opzioni hour, minute e second selezionano i componenti dell’ora. Se hour12 non è impostato, hourCycle: 'h23' imposta le ore da 0 a 23. L’opzione hour12 ha la precedenza su hourCycle: se si specificano sia hour12: true sia hourCycle: 'h23', viene usato un ciclo di 12 ore. Se non si specificano né uno stile né componenti dell’ora, vengono inclusi per impostazione predefinita ora, minuti e secondi.
È possibile usare timeStyle, ad esempio 'short', al posto delle opzioni esplicite per i componenti. Quando si formatta una data valida, combinare timeStyle con un’opzione per un componente, come hour, genera un TypeError. Per una data valida, specificare dateStyle in una chiamata a toLocaleTimeString() genera a sua volta un TypeError, anche se è l’unica opzione. Se l’oggetto Date non è valido, il metodo restituisce "Invalid Date" prima di elaborare le opzioni, quindi in quel caso la combinazione di timeStyle e hour non genera errori. Un ricevente che non è un oggetto Date causa un TypeError.
Il risultato è destinato alla visualizzazione per l’utente, non a un’archiviazione stabile o all’analisi: i dati della locale possono modificare punteggiatura e spazi. L’esempio fissa l’istante, la locale, il fuso UTC, il ciclo orario e il sistema di numerazione per ridurre le variazioni. Per formattazioni ripetute, è utile creare un solo Intl.DateTimeFormat e riutilizzarne il metodo format.
Esempi
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);Risultato
13:05:09
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.