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