Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Intl.DateTimeFormat.formatToParts(): dijelovi datuma i vremena

Dohvati dijelove lokaliziranog datuma ili vremena kako bi oblikovao pojedini dio bez nagađanja redoslijeda polja ili dijeljenja teksta po interpunkciji.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

formatter.formatToParts()
formatter.formatToParts(date)

Intl.DateTimeFormat.prototype.formatToParts metoda je instance Intl.DateTimeFormat. Umjesto jednog znakovnog niza koji vraća format(), vraća polje objekata { type, value } redoslijedom prikaza. Oba su svojstva znakovni nizovi. Spajanjem svih vrijednosti value pomoću join("") dobivaš rezultat format() za isti objekt za formatiranje i isti ulaz. Za razliku od funkcije koju vraća format, metoda formatToParts nije automatski vezana uz instancu. Kao povratnu funkciju proslijedi date => formatter.formatToParts(date) ili upotrijebi bind; nekompatibilan this izaziva TypeError.

Odaberi dijelove prema type, primjerice month ili dayPeriod, a ne prema indeksu u polju. Zadrži dijelove literal: mogu sadržavati razmake, interpunkcijske znakove ili riječi. U nekim kalendarima umjesto year pojavljuje se relatedYear (odgovarajuća gregorijanska godina), ponekad uz yearName (naziv godine). Zadrži i nepoznate dijelove. Regionalne postavke, opcije i podaci izvršnog okruženja mogu utjecati na rezultat. Dijelove upotrebljavaj za prikaz, ne za raščlanjivanje ili pohranu. U pregledniku umetni vrijednosti kao tekst pomoću textContent, a ne pomoću innerHTML.

U ECMA-402 za ECMAScript 2024 proslijedi Date ili broj milisekundi od Unixove epohe. Metoda pretvara argument u broj; ne tumači znakovne nizove kao datume. Ako izostaviš argument ili proslijediš undefined, upotrebljava se trenutačno vrijeme u trenutku poziva. Nevaljan Date ili vremenska oznaka izvan raspona izaziva RangeError.

Izvršna okruženja s integracijom Temporal prihvaćaju i Temporal.Instant te tipove Temporal.Plain* određene za ovu metodu, uz ograničenja kalendara i formatiranja ovisna o tipu. Provjeri podršku u ciljnom okruženju. Izravno prosljeđivanje objekta Temporal.ZonedDateTime izaziva TypeError. Za dijelove istog trenutka u njegovoj vremenskoj zoni proslijedi rezultat toInstant() i postavi timeZone objekta za formatiranje na zonu tog objekta.

Primjeri

{
  const formatter = new Intl.DateTimeFormat("en-US", {
    timeZone: "UTC",
    calendar: "gregory",
    year: "numeric",
    month: "long",
    day: "numeric",
  });
  const date = new Date("2024-07-05T12:00:00Z");
  const parts = formatter.formatToParts(date);

  console.log(parts.some(({ type }) => type === "month"));
  console.log(parts.map(({ value }) => value).join("") === formatter.format(date));
}

Rezultat

true
true

Primjer zadaje trenutak, regionalne postavke i vremensku zonu UTC. Prvi `true` potvrđuje prisutnost dijela `month`. Drugi potvrđuje da spojene vrijednosti odgovaraju rezultatu `format(date)`, bez pretpostavki o konkretnim razdjelnicima.

Povezane lekcije

  • JavaScript · Lekcija 25 · Napredno · Verzija: 4

Izvori