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

CKTIS / JavaScript

Intl.DateTimeFormat.formatToParts(): части на датата и часа

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

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

Синтаксис

formatter.formatToParts()
formatter.formatToParts(date)

Intl.DateTimeFormat.prototype.formatToParts е метод на екземпляр на Intl.DateTimeFormat. Вместо единичния низ от format() получаваш масив от обекти { type, value } в реда на показване. И двете свойства са низове. Ако съединиш всички стойности value с join(""), получаваш резултата от format() за същия форматиращ обект и същия вход. За разлика от функцията, връщана от format, formatToParts не е автоматично обвързан с екземпляра. Подай date => formatter.formatToParts(date) като функция за обратно извикване или използвай bind; несъвместимо this предизвиква TypeError.

Избирай частите по type, например month или dayPeriod, а не по индекс. Запазвай частите literal: те могат да съдържат интервали, препинателни знаци или думи. При някои календари relatedYear (съответната григорианска година) замества year, понякога заедно с yearName (името на годината). Запазвай и непознатите части. Регионалните настройки, опциите и данните на средата за изпълнение могат да повлияят на резултата. Използвай частите за показване, не за разчитане или съхранение на данни. В браузъра вмъквай стойностите като текст чрез textContent, а не чрез innerHTML.

В ECMA-402 за ECMAScript 2024 подай Date или брой милисекунди от началото на епохата на Unix. Методът преобразува аргумента в число; не разчита низове като дати. При пропуснат аргумент или undefined се използва текущото време при извикването. Невалиден Date или времева стойност извън допустимия диапазон предизвиква RangeError.

Средите с интеграция на Temporal приемат и Temporal.Instant, както и типовете Temporal.Plain*, определени за този метод, с ограничения за календара и форматирането според типа. Провери поддръжката в целевата среда. Директното подаване на Temporal.ZonedDateTime предизвиква TypeError. За да получиш частите на същия момент в неговата часова зона, подай резултата от toInstant() и задай timeZone на форматиращия обект на зоната на този обект.

Примери

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

Резултат

true
true

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

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

  • JavaScript · Урок 25 · Напреднало · Версия: 4

Източници