Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Intl.DateTimeFormat — lokalizované formátování data a času

Intl.DateTimeFormat formátuje datum a čas podle místních konvencí a zvoleného časového pásma. Seznamte se s format(), formatToParts(), resolvedOptions() a rozdílem mezi timeZone a hourCycle.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

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

Intl.DateTimeFormat patří do internacionalizačního standardu ECMA-402, nikoli do DOM API. Vytvořte formatter pomocí new Intl.DateTimeFormat(locales, options) a používejte jej opakovaně. Locale určuje konvence zobrazení; automaticky nevybírá časové pásmo odpovídající dané zemi.

Názvy Intl.DateTimeFormat.format a Intl.DateTimeFormat.formatToParts zde označují operace instance, nikoli statické metody konstruktoru. formatter.format(date) vrací text; vlastnost format je přístupový člen, který poskytuje svázanou funkci. formatter.formatToParts(date) vrací seřazené objekty { type, value }, včetně částí literal. Spojením všech hodnot value znovu vytvoříte výsledek format(date). Lokalizovaný text nerozebírejte dělením podle oddělovačů.

timeZone, například UTC nebo Europe/Warsaw, vybírá pásmo pro zobrazení stejného okamžiku, aniž by změnilo objekt Date. Pokud možnost vynecháte, použije se časové pásmo prostředí. hourCycle určuje rozsah hodin: h11 je 0–11, h12 1–12, h23 0–23 a h24 1–24. Záleží na něm při formátování hodin; pokud je zadána možnost hour12, má přednost.

Intl.DateTimeFormat.prototype.resolvedOptions, volané jako formatter.resolvedOptions(), zpřístupňuje skutečně vybraná nastavení, včetně locale, timeZone a, pokud formát obsahuje hodiny, hourCycle. Lokalizační data se mohou v různých prostředích lišit, proto nepředpokládejte totožnou interpunkci ani mezery. Standard není tabulka kompatibility prohlížečů: ověřte požadované metody a možnosti v cílových prostředích; Node 24 nedokládá podporu v prohlížečích.

Pří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ýsledek

00:05
true
h23

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje