Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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