CKTIS / JavaScript
Intl.DateTimeFormat — lokalizowane formatowanie daty i czasu
Intl.DateTimeFormat formatuje datę i czas zgodnie z ustawieniami regionalnymi oraz wybraną strefą czasową. Poznaj format(), formatToParts(), resolvedOptions() i różnicę między timeZone a hourCycle.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.formatToParts(date);
formatter.resolvedOptions();Intl.DateTimeFormat należy do standardu internacjonalizacji ECMA-402, a nie do API DOM. Twórz formatter przez new Intl.DateTimeFormat(locales, options) i używaj go wielokrotnie. Ustawienia regionalne określają konwencje prezentacji; nie wybierają automatycznie strefy odpowiadającej danemu krajowi.
Nazwy Intl.DateTimeFormat.format i Intl.DateTimeFormat.formatToParts oznaczają tutaj operacje na instancji, nie metody statyczne konstruktora. formatter.format(date) zwraca tekst; właściwość format jest akcesorem udostępniającym związaną funkcję. formatter.formatToParts(date) zwraca uporządkowane obiekty { type, value }, również części literal. Połączenie wszystkich value odtwarza wynik format(date). Nie parsuj lokalizowanego tekstu przez dzielenie po separatorach.
timeZone, np. UTC lub Europe/Warsaw, wybiera strefę prezentacji tego samego momentu, bez zmiany obiektu Date. Pominięcie opcji wybiera strefę środowiska. hourCycle wybiera zakres godzin: h11 to 0–11, h12 to 1–12, h23 to 0–23, a h24 to 1–24. Ma znaczenie przy formatowaniu godzin; opcja hour12, jeśli podana, ma pierwszeństwo.
Intl.DateTimeFormat.prototype.resolvedOptions, wywoływane jako formatter.resolvedOptions(), ujawnia faktycznie wybrane ustawienia, m.in. locale, timeZone i, gdy format obejmuje godziny, hourCycle. Dane regionalne mogą różnić się między środowiskami, więc nie zakładaj identycznej interpunkcji ani odstępów. Standard nie jest tabelą zgodności przeglądarek: sprawdź wymagane metody i opcje w docelowych środowiskach; Node 24 nie dowodzi ich obsługi w przeglądarce.
Przykłady
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);Wynik
00:05 true h23
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.
Źródła
- ECMAScript® 2027 Internationalization API Specification
- ECMAScript® 2024 Internationalization API Specification
- ECMAScript® 2026 Internationalization API Specification
- Official reference — tc39.es: ecma402
- Official reference — tc39.es: ecma402
- Official reference — developer.mozilla.org: Intl / DateTimeFormat