Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori