CKTIS / JavaScript
Intl.DateTimeFormat: pridobivanje delov datuma z metodo formatToParts()
Pridobi dele lokaliziranega datuma ali časa, da lahko poudariš na primer mesec, ne da bi besedilo razdelil po ločilih ali predpostavil stalen vrstni red polj.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
formatter.formatToParts()
formatter.formatToParts(date)formatToParts() je metoda primerka Intl.DateTimeFormat, določena na Intl.DateTimeFormat.prototype, in ne statična metoda konstruktorja. Pokliči jo kot formatter.formatToParts(date). Za razliko od format() ni samodejno vezana na primerek: klic ločeno shranjene funkcije brez pravilnega this sproži TypeError.
Podaj objekt Date ali časovni žig v milisekundah od začetka Unixove epohe, ne v sekundah. Če argument izpustiš ali podaš undefined, se uporabi trenutni čas iz Date.now(). Neveljaven Date ali časovni žig zunaj dovoljenega obsega sproži RangeError. Metoda oblikuje vrednosti, ne razčlenjuje besedila z datumom. Okolja z integracijo Temporal lahko sprejmejo tudi nekatere tipe Temporal.Plain*; če neposredno podaš Temporal.ZonedDateTime, se sproži TypeError.
Rezultat je tabela objektov { type, value } v vrstnem redu prikaza; obe lastnosti sta niza. Vrednost type, kot je month, day ali year, označuje polje. literal označuje besedilo vzorca, na primer vejico, presledek ali besedo. Pri koledarjih s poimenovanimi leti se lahko namesto year pojavi relatedYear (ustrezno gregorijansko leto); vzorec lahko vsebuje tudi yearName (ime leta).
Dele izbiraj po type, ne po indeksu v tabeli. Če želiš dobiti enak rezultat kot pri format() za isti primerek in datum, sestavi vse nize value brez ločila, vključno z deli tipa literal. Na rezultat vplivajo območne nastavitve in možnosti, kot sta koledar in časovni pas. Zapis in ločila se lahko med okolji razlikujejo tudi pri enakih območnih nastavitvah. Rezultata ne uporabljaj kot zapisa za izmenjavo podatkov.
Primeri
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
Primer določi datum, območne nastavitve in časovni pas UTC. Prvi `true` potrdi prisotnost dela `month`, drugi pa, da se združene vrednosti ujemajo z rezultatom `format()`.
Povezane lekcije
- JavaScript · Lekcija 15 · Osnovna · Različica: 4