Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Date.prototype.toLocaleTimeString() — lokalizirano oblikovanje časa

toLocaleTimeString() vrne besedilni prikaz časa objekta Date glede na izbrane jezikovne nastavitve in možnosti. Omogoča izbiro časovnega pasu, sestavnih delov časa in urnega cikla, ne da bi spremenila datum.

Različica: 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 označuje instančno metodo Date.prototype.toLocaleTimeString, ne pa statične metode konstruktorja Date. Klic date.toLocaleTimeString(locales, options) vrne niz in ne spremeni date. Tukaj opisano delovanje parametrov velja za okolja, ki podpirajo ECMA-402 (Intl).

locales sprejme jezikovno oznako, na primer pl-PL, ali seznam prednostnih oznak. Če argument izpustite, se uporabi privzeta jezikovna nastavitev okolja. options.timeZone izbere časovni pas za prikaz; sicer se uporabi pas okolja. Možnosti hour, minute in second izberejo sestavne dele časa. Če možnost hour12 ni nastavljena, hourCycle: 'h23' določi ure od 0 do 23. Možnost hour12 ima prednost pred hourCycle: če hkrati nastavite hour12: true in hourCycle: 'h23', se uporabi 12-urni cikel. Če ne določite sloga ali sestavnih delov časa, so privzeto vključene ura, minute in sekunde.

Namesto izrecnih možnosti za sestavne dele lahko uporabite timeStyle, na primer 'short'. Pri oblikovanju veljavnega datuma kombinacija timeStyle z možnostjo za sestavni del časa, kot je hour, sproži napako TypeError. Če pri klicu toLocaleTimeString() za veljaven datum nastavite dateStyle, se prav tako sproži TypeError, tudi če je to edina možnost. Pri neveljavnem objektu Date metoda vrne "Invalid Date", preden obdela možnosti, zato kombinacija timeStyle in hour v tem primeru ne sproži napake. Sprejemnik, ki ni objekt Date, povzroči TypeError.

Rezultat je namenjen prikazu uporabniku, ne stabilnemu shranjevanju ali razčlenjevanju: jezikovni podatki lahko spremenijo ločila in presledke. Primer določi trenutek, jezikovno nastavitev, pas UTC, urni cikel in številski sistem, da omeji razlike. Pri ponavljajočem se oblikovanju razmislite o ustvarjanju enega objekta Intl.DateTimeFormat in ponovni uporabi njegove metode format.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri