Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Intl.DateTimeFormat — lokalizirano oblikovanje datuma in časa

Intl.DateTimeFormat oblikuje datume in čase v skladu z lokalnimi konvencijami in izbranim časovnim pasom. Spoznajte format(), formatToParts(), resolvedOptions() ter razliko med timeZone in hourCycle.

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

Sintaksa

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

Intl.DateTimeFormat je del internacionalizacijskega standarda ECMA-402, ne DOM API-ja. Ustvarite formatter z new Intl.DateTimeFormat(locales, options) in ga uporabljajte večkrat. Locale določa pravila prikaza; ne izbere samodejno časovnega pasu, ki ustreza določeni državi.

Imeni Intl.DateTimeFormat.format in Intl.DateTimeFormat.formatToParts tukaj pomenita operaciji na primerku, ne statičnih metod konstruktorja. formatter.format(date) vrne besedilo; lastnost format je dostopnik, ki zagotovi vezano funkcijo. formatter.formatToParts(date) vrne urejene objekte { type, value }, vključno z deli literal. S povezovanjem vseh vrednosti value ponovno sestavite format(date). Lokaliziranega besedila ne razčlenjujte z deljenjem po ločilih.

timeZone, na primer UTC ali Europe/Warsaw, izbere pas za prikaz istega trenutka, ne da bi spremenil objekt Date. Če možnost izpustite, se uporabi časovni pas okolja. hourCycle določa razpon ur: h11 je 0–11, h12 1–12, h23 0–23 in h24 1–24. Pomemben je pri oblikovanju ur; če je podana možnost hour12, ima prednost.

Intl.DateTimeFormat.prototype.resolvedOptions, poklican kot formatter.resolvedOptions(), razkrije dejansko izbrane nastavitve, med njimi locale, timeZone in, kadar oblika vključuje ure, hourCycle. Lokalni podatki se lahko med okolji razlikujejo, zato ne predpostavljajte enakega ločenja z ločili ali presledkov. Standard ni tabela združljivosti brskalnikov: zahtevane metode in možnosti preverite v ciljnih okoljih; Node 24 ne dokazuje podpore v brskalnikih.

Primeri

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);

Rezultat

00:05
true
h23

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri