Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Intl.DateTimeFormat — lokalizované formátovanie dátumu a času

Intl.DateTimeFormat formátuje dátum a čas podľa miestnych konvencií a zvoleného časového pásma. Zoznámte sa s format(), formatToParts(), resolvedOptions() a rozdielom medzi timeZone a hourCycle.

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

const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.formatToParts(date);
formatter.resolvedOptions();

Intl.DateTimeFormat patrí do internacionalizačného štandardu ECMA-402, nie do DOM API. Vytvorte formatter pomocou new Intl.DateTimeFormat(locales, options) a opakovane ho používajte. Locale určuje konvencie zobrazenia; automaticky nevyberá časové pásmo zodpovedajúce danej krajine.

Názvy Intl.DateTimeFormat.format a Intl.DateTimeFormat.formatToParts tu označujú operácie inštancie, nie statické metódy konštruktora. formatter.format(date) vracia text; vlastnosť format je prístupový člen, ktorý poskytuje naviazanú funkciu. formatter.formatToParts(date) vracia zoradené objekty { type, value }, vrátane častí literal. Spojením všetkých hodnôt value obnovíte výsledok format(date). Lokalizovaný text nerozoberajte delením podľa oddeľovačov.

timeZone, napríklad UTC alebo Europe/Warsaw, vyberá pásmo na zobrazenie toho istého okamihu bez zmeny objektu Date. Ak možnosť vynecháte, použije sa časové pásmo prostredia. hourCycle určuje rozsah hodín: h11 je 0–11, h12 1–12, h23 0–23 a h24 1–24. Je dôležitý pri formátovaní hodín; ak zadáte možnosť hour12, má prednosť.

Intl.DateTimeFormat.prototype.resolvedOptions, volané ako formatter.resolvedOptions(), sprístupňuje skutočne zvolené nastavenia vrátane locale, timeZone a, ak formát obsahuje hodiny, hourCycle. Lokalizačné údaje sa môžu v rôznych prostrediach líšiť, preto nepredpokladajte rovnakú interpunkciu ani medzery. Štandard nie je tabuľka kompatibility prehliadačov: overte požadované metódy a možnosti v cieľových prostrediach; Node 24 nedokazuje podporu v prehliadačoch.

Príklady

const formatter = new Intl.DateTimeFormat('en-GB', {
  timeZone: 'UTC',
  numberingSystem: 'latn',
  hour: '2-digit',
  minute: '2-digit',
  hourCycle: 'h23'
});
const date = new Date('2024-01-02T00:05:00Z');
const parts = formatter.formatToParts(date);
const field = type => parts.find(part => part.type === type).value;
console.log(`${field('hour')}:${field('minute')}`);
console.log(parts.map(part => part.value).join('') === formatter.format(date));
console.log(formatter.resolvedOptions().hourCycle);

Výsledok

00:05
true
h23

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje