CKTIS / JavaScript
Date.prototype.toLocaleTimeString() — lokalizované formátovanie času
toLocaleTimeString() vracia textovú reprezentáciu času objektu Date podľa zvoleného locale a možností. Umožňuje vybrať časové pásmo, zložky času a hodinový cyklus bez zmeny dátumu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
date.toLocaleTimeString(locales?, options?)Katalógový symbol Date.toLocaleTimeString označuje inštančnú metódu Date.prototype.toLocaleTimeString, nie statickú metódu konštruktora Date. Volanie date.toLocaleTimeString(locales, options) vracia reťazec a nemení date. Tu opísané správanie parametrov platí pre prostredia podporujúce ECMA-402 (Intl).
locales prijíma jazykovú značku, napríklad pl-PL, alebo zoznam uprednostňovaných značiek. Ak tento argument vynecháte, použije sa predvolené locale prostredia. options.timeZone vyberá časové pásmo zobrazenia; inak sa použije pásmo prostredia. Možnosti hour, minute a second vyberajú zložky času. Ak nie je nastavená možnosť hour12, hourCycle: 'h23' nastavuje hodiny od 0 do 23. Možnosť hour12 má prednosť pred hourCycle: ak zadáte súčasne hour12: true aj hourCycle: 'h23', použije sa 12-hodinový cyklus. Ak nie je zadaný štýl ani zložky času, predvolene sa zahrnú hodiny, minúty a sekundy.
Namiesto výslovných možností zložiek môžete použiť timeStyle, napríklad 'short'. Pri formátovaní platného dátumu kombinácia timeStyle s možnosťou pre zložku času, napríklad hour, vyvolá chybu TypeError. Ak pri volaní toLocaleTimeString() pre platný dátum zadáte dateStyle, vyvolá sa tiež TypeError, aj keď je to jediná možnosť. Pri neplatnom objekte Date metóda vráti "Invalid Date" ešte pred spracovaním možností, takže kombinácia timeStyle a hour v tomto prípade chybu nevyvolá. Príjemca, ktorý nie je objektom Date, spôsobí TypeError.
Výsledok je určený na zobrazenie používateľovi, nie na stabilné ukladanie alebo parsovanie: lokalizačné údaje môžu meniť interpunkciu a medzery. Príklad pevne určuje okamih, locale, pásmo UTC, hodinový cyklus a číselnú sústavu, aby obmedzil odchýlky. Pri opakovanom formátovaní zvážte vytvorenie jedného objektu Intl.DateTimeFormat a opätovné použitie jeho metódy format.
Príklady
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);Výsledok
13:05:09
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.