Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Intl.DateTimeFormat: dohvaćanje dijelova datuma metodom formatToParts()

Dohvati dijelove lokaliziranog datuma ili vremena kako bi istaknuo polje poput mjeseca, bez razdvajanja teksta po razdjelnicima i bez pretpostavljanja redoslijeda polja.

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

Sintaksa

formatter.formatToParts()
formatter.formatToParts(date)

formatToParts() metoda je instance Intl.DateTimeFormat, definirana na Intl.DateTimeFormat.prototype, a ne statička metoda konstruktora. Pozovi je kao formatter.formatToParts(date). Za razliku od format(), nije automatski vezana uz instancu: poziv izdvojene funkcije bez ispravne vrijednosti this izaziva TypeError.

Proslijedi objekt Date ili vremensku oznaku u milisekundama od Unixove epohe, a ne u sekundama. Ako izostaviš argument ili proslijediš undefined, upotrebljava se trenutačno vrijeme iz Date.now(). Nevaljan Date ili vremenska oznaka izvan raspona izaziva RangeError. Metoda oblikuje vrijednosti; ne raščlanjuje tekstualni zapis datuma. Okruženja s integracijom Temporal mogu prihvatiti i neke tipove Temporal.Plain*; izravno prosljeđivanje objekta Temporal.ZonedDateTime izaziva TypeError.

Rezultat je niz objekata { type, value } prema redoslijedu prikaza; oba su svojstva znakovni nizovi. Vrijednost type poput month, day ili year označava polje. literal označava tekst iz uzorka, primjerice zarez, razmak ili riječ. U kalendarima u kojima godine imaju imena, relatedYear (odgovarajuća gregorijanska godina) može zamijeniti year, a uzorak može sadržavati i yearName (ime godine).

Biraj dijelove prema type, ne prema indeksu u nizu. Za isti rezultat kao pri pozivu format() s istom instancom i istim datumom spoji sve vrijednosti value bez razdjelnika, uključujući one tipa literal. Na rezultat utječu regionalne postavke i opcije poput kalendara i vremenske zone. Točan zapis i interpunkcija mogu se razlikovati među okruženjima čak i uz iste regionalne postavke. Nemoj upotrebljavati rezultat kao format za razmjenu podataka.

Primjeri

const formatter = new Intl.DateTimeFormat("en-US", {
  timeZone: "UTC",
  year: "numeric",
  month: "long",
  day: "numeric",
});
const date = new Date("2024-07-09T12: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 datum, regionalne postavke i vremensku zonu UTC. Prvi `true` potvrđuje da postoji dio `month`, a drugi da spojene vrijednosti odgovaraju rezultatu poziva `format()`.

Povezane lekcije

  • JavaScript · Lekcija 15 · Osnovno · Verzija: 4

Izvori