CKTIS / JavaScript
Date.prototype.toLocaleTimeString() — lokalizirano oblikovanje vremena
toLocaleTimeString() vraća tekstualni prikaz vremena objekta Date prema odabranim jezičnim postavkama i opcijama. Omogućuje odabir vremenske zone, dijelova vremena i ciklusa sati bez promjene datuma.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
date.toLocaleTimeString(locales?, options?)Kataloški simbol Date.toLocaleTimeString odnosi se na instancijsku metodu Date.prototype.toLocaleTimeString, a ne na statičku metodu konstruktora Date. Poziv date.toLocaleTimeString(locales, options) vraća niz znakova i ne mijenja date. Ovdje opisano ponašanje parametara vrijedi za okruženja koja podržavaju ECMA-402 (Intl).
locales prihvaća jezičnu oznaku, primjerice pl-PL, ili popis željenih oznaka. Ako ga izostavite, upotrebljavaju se zadane jezične postavke okruženja. options.timeZone odabire vremensku zonu prikaza; u suprotnom se upotrebljava zona okruženja. Opcije hour, minute i second odabiru dijelove vremena. Ako opcija hour12 nije zadana, hourCycle: 'h23' postavlja sate od 0 do 23. Opcija hour12 ima prednost pred opcijom hourCycle: ako istodobno zadate hour12: true i hourCycle: 'h23', upotrebljava se 12-satni ciklus. Ako se ne zadaju stil ni dijelovi vremena, zadano se uključuju sat, minute i sekunde.
Umjesto izričitih opcija za dijelove vremena možete upotrijebiti timeStyle, primjerice 'short'. Pri oblikovanju valjanog datuma kombinacija timeStyle s opcijom za dio vremena, kao što je hour, izaziva pogrešku TypeError. Ako pri pozivu toLocaleTimeString() za valjan datum zadate dateStyle, također se javlja TypeError, čak i ako je to jedina opcija. Za nevaljani objekt Date metoda vraća "Invalid Date" prije obrade opcija, pa kombinacija timeStyle i hour u tom slučaju ne izaziva pogrešku. Primatelj koji nije objekt Date uzrokuje TypeError.
Rezultat je namijenjen prikazu korisniku, a ne stabilnoj pohrani ili parsiranju: jezični podaci mogu promijeniti interpunkciju i razmake. Primjer određuje trenutak, jezične postavke, UTC zonu, ciklus sati i sustav numeriranja kako bi smanjio odstupanja. Za ponovljeno formatiranje razmislite o stvaranju jednog objekta Intl.DateTimeFormat i ponovnoj upotrebi njegove metode format.
Primjeri
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);Rezultat
13:05:09
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.