CKTIS / JavaScript
Intl.DateTimeFormat.formatToParts(): deli datuma in časa
Pridobi dele lokaliziranega datuma ali časa in oblikuj posamezen del, ne da bi ugibal vrstni red polj ali razdeljeval besedilo po ločilih.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
formatter.formatToParts()
formatter.formatToParts(date)Intl.DateTimeFormat.prototype.formatToParts je metoda primerka Intl.DateTimeFormat. Namesto enega niza, ki ga vrne format(), vrne tabelo objektov { type, value } v vrstnem redu prikaza. Obe lastnosti sta niza. Če vse vrednosti value združiš z join(""), dobiš rezultat format() za isti oblikovalnik in isti vhod. V nasprotju s funkcijo, ki jo vrne format, metoda formatToParts ni samodejno vezana na primerek. Kot povratni klic podaj date => formatter.formatToParts(date) ali uporabi bind; nezdružljiv this sproži TypeError.
Dele izbiraj po type, na primer month ali dayPeriod, ne po indeksu v tabeli. Ohrani dele literal: lahko vsebujejo presledke, ločila ali besede. Pri nekaterih koledarjih se namesto year pojavi relatedYear (ustrezno gregorijansko leto), včasih skupaj z yearName (imenom leta). Ohrani tudi dele, ki jih ne prepoznaš. Na rezultat lahko vplivajo krajevne nastavitve, možnosti in podatki izvajalnega okolja. Dele uporabljaj za prikaz, ne za razčlenjevanje ali shranjevanje. V brskalniku vrednosti vstavi kot besedilo s textContent, ne z innerHTML.
V ECMA-402 za ECMAScript 2024 podaj Date ali število milisekund od začetka Unixove epohe. Metoda argument pretvori v število; nizov ne razčlenjuje kot datumov. Če argument izpustiš ali podaš undefined, uporabi trenutni čas ob klicu. Neveljaven Date ali časovni žig zunaj obsega sproži RangeError.
Okolja z integracijo Temporal sprejmejo tudi Temporal.Instant in tipe Temporal.Plain*, določene za to metodo, z omejitvami koledarja in oblikovanja glede na tip. Preveri podporo v ciljnem okolju. Če neposredno podaš Temporal.ZonedDateTime, se sproži TypeError. Če želiš dele istega trenutka v njegovem časovnem pasu, podaj rezultat toInstant() in nastavi timeZone oblikovalnika na pas tega objekta.
Primeri
{
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
Primer določi trenutek, krajevne nastavitve in časovni pas UTC. Prvi `true` potrdi prisotnost dela `month`. Drugi potrdi, da se združene vrednosti ujemajo z `format(date)`, ne da bi predpostavili določena ločila.
Povezane lekcije
- JavaScript · Lekcija 25 · Napredna · Različica: 4