База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Intl.DateTimeFormat: извличане на части от дата с formatToParts()

Извлечете частите на локализирана дата или час, за да откроите например месеца, без да разделяте текста по разделители или да разчитате на фиксиран ред на полетата.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

formatter.formatToParts()
formatter.formatToParts(date)

formatToParts() е метод на екземпляр на Intl.DateTimeFormat, дефиниран върху Intl.DateTimeFormat.prototype, а не статичен метод на конструктора. Извикайте го като formatter.formatToParts(date). За разлика от format(), методът не се обвързва автоматично с екземпляра: извикването на отделената функция без правилната стойност на this води до TypeError.

Подайте обект Date или времеви печат в милисекунди от началото на епохата на Unix, не в секунди. При пропуснат аргумент или подадено undefined се използва текущото време от Date.now(). Невалиден Date или времеви печат извън допустимия диапазон води до RangeError. Методът форматира стойности, а не разчита дата от текст. Средите с интеграция на Temporal могат да приемат и някои типове Temporal.Plain*; директното подаване на Temporal.ZonedDateTime води до TypeError.

Резултатът е масив от обекти { type, value } в реда на показване; и двете свойства са низове. Стойност на type като month, day или year обозначава поле. literal отбелязва текст от шаблона, например запетая, интервал или дума. При календари с именувани години relatedYear (съответната година по григорианския календар) може да замени year, а шаблонът може да съдържа и yearName (името на годината).

Избирайте частите по type, а не по индекс в масива. За да получите същия резултат като от format() със същия екземпляр и същата дата, съединете всички низове value без разделител, включително тези от тип literal. Регионалните настройки и опции като календар и часова зона влияят на резултата. Точното изписване и пунктуацията могат да се различават между средите дори при едни и същи регионални настройки. Не използвайте резултата като формат за обмен на данни.

Примери

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));

Резултат

true
true

Примерът задава конкретна дата, регионални настройки и часова зона UTC. Първото `true` потвърждава, че има част `month`, а второто — че съединените стойности съвпадат с резултата от `format()`.

Свързани уроци

  • JavaScript · Урок 15 · Начално · Версия: 4

Източници