Разработка веб-приложений нередко упирается в больную точку: управление датами и временем. Если вы когда-нибудь пытались учесть часовые пояса, переход на летнее время (DST), а вдобавок ещё и разные календари, то наверняка знаете, насколько громоздким может быть решение подобных задач в JavaScript. Однако нас ждут большие перемены: в экспериментальных версиях браузеров уже начала появляться Temporal — новая спецификация JavaScript, которая должна упростить и усовершенствовать работу со временем.
Тем, кто до сих пор мучился с устаревшим Date (и "оброс" библиотеками вроде Moment.js или date-fns), стоит присмотреться к этому новшеству. Предлагаю вместе разобраться, чем так примечателен Temporal, как его использовать, и заодно поделюсь своими мыслями о будущем этого нововведения.
Почему Date всех достал и чем его заменит Temporal
С момента создания JavaScript прошло почти три десятка лет, а объект Date в нём так и остался «родом из 90-х»:
- 🔎 Избирательная поддержка часовых поясов (реально — только локальный и UTC);
- ❌ Странная логика парсинга дат, ведущая к ошибкам;
- ♻️ Мутируемость (свойство объекта изменяться после создания) не самый надёжный вариант для отладки сложных систем;
- ⏰ «Акробатика» с DST (Daylight Saving Time - летнее время, перевод часов вперед/назад), календарями и прочими локальными особенностями.
Новая спецификация Temporal фактически призвана заменить Date. Здесь учли извечные проблемы разработчиков и добавили:
- 🌍 Поддержку часовых поясов и календарей напрямую «из коробки»;
- 🔒 Иммутабельность (свойство объекта не изменяться после создания) объектов - нет риска незаметных побочных изменений;
- 💡 Богатый набор методов (более 200!) для сравнения, арифметики дат и форматирования;
- 🏷 Удобные типы: от точечных временных «инстантов» (моментов в истории) до «чистых» дат и времени без таймзоны.
На MDN уже появились сотни страниц свежей документации, где детально описаны все эти возможности.
Ключевые понятия и объекты
Чтобы освоиться в новой API, полезно понять логику распределения классов. По сути, её можно разделить на несколько больших категорий:
- ⏱ Instants (Temporal.Instant)
Абсолютные точки во времени. Удобны при работе с Unix-временем или хранением отметок в БД. - 🌍 ZonedDateTime (Temporal.ZonedDateTime)
Дата + время + чётко заданный часовой пояс. Для случаев, когда важно, в каком регионе «запланировано» событие. - 📅 PlainDate, PlainTime, PlainDateTime
«Чистые» варианты без временной зоны: когда нужно оперировать самими числами (год, месяц, день) без привязки к географии. - ⏳ Duration (Temporal.Duration)
Интервалы (например, 1 час 30 минут). Очень кстати, когда требуется сложить или вычесть промежутки из дат, делать расписания. - 🕰 Now (Temporal.now)
Набор методов для получения текущего момента с разными форматами (в «сыром» виде Instant, или с часовым поясом, или только дата и т.п.).
Технические детали и примеры
Уже сейчас можно поиграться с Temporal в разных средах. Например, в Firefox Nightly (активировав флаг javascript.options.experimental.temporal), а также через полифилл @js-temporal/polyfill. Вот небольшая подборка типичных сценариев:
- 🗺 Получить текущую дату в конкретной таймзоне:
const dateTimeNY = Temporal.Now.plainDateTimeISO("America/New_York");
console.log(dateTimeNY);
// Например: 2025-01-22T05:47:02.555 - 🏮 Работа с нестандартными календарями (китайский, иврит, исламский и др.):
// Следующая дата Китайского Нового года
const chineseNewYear = Temporal.PlainMonthDay.from({
monthCode: "M01",
day: 1,
calendar: "chinese",
});
const currentYear = Temporal.Now.plainDateISO().withCalendar("chinese").year;
let nextCNY = chineseNewYear.toPlainDate({ year: currentYear });
if (Temporal.PlainDate.compare(nextCNY, Temporal.Now.plainDateISO()) <= 0) {
nextCNY = nextCNY.add({ years: 1 });
}
console.log(
`Следующий Китайский Новый год наступит ${nextCNY.withCalendar("iso8601").toLocaleString()}`
); - 🚀 Арифметика с моментами во времени:
// "Отсчёт" до события по unix-timestamp
const launch = Temporal.Instant.fromEpochMilliseconds(1851222399924);
const now = Temporal.Now.instant();
const duration = now.until(launch, { smallestUnit: "hour" });
console.log(`До запуска осталось ${duration.toLocaleString("en-US")}`); - 📐 Сравнение длительностей:
const durations = [
Temporal.Duration.from({ hours: 1 }),
Temporal.Duration.from({ hours: 2 }),
Temporal.Duration.from({ hours: 1, minutes: 30 }),
Temporal.Duration.from({ hours: 1, minutes: 45 }),
];
durations.sort(Temporal.Duration.compare);
console.log(durations.map((d) => d.toString()));
// Выведет: [ 'PT1H', 'PT1H30M', 'PT1H45M', 'PT2H' ]
Во многих случаях Temporal избавляет от громоздкого кода и уязвимостей. Сейчас продолжается обсуждение того, как лучше форматировать большие интервалы (например, когда нужно указать «31 600 часов до запуска»), но сам фундамент API уже весьма солидный.
Поддержка в браузерах
- 🦊 Firefox Nightly уже имеет наиболее продвинутую реализацию (активируется через about:config).
- 🍎 Safari ведёт работы.
- 🌐 Chrome/Chromium также в процессе внедрения.
А пока что используйте полифилл @js-temporal/polyfill или экспериментальные флаги, чтобы оценить преимущества прямо сейчас.
Личное мнение и почему это круто
Мне кажется, что появление Temporal — это как минимум исторический момент для JavaScript-сообщества, ведь почти три десятка лет мы мирились с неповоротливым Date. Теперь разработчикам не придётся каждый раз перепрыгивать через костыли, чтобы корректно посчитать дату в разных часовых поясах и календарях.
Да, пока что есть шероховатости (особенно в локализации больших длительностей), но в основе лежат чёткие концепции. Инструмент становится более понятным, а значит — менее склонным к ошибкам. Думаю, разработка API «на уровне языка», которая учитывает такие тонкие моменты, сделает JavaScript более зрелым и удобным.
Особенно радует, что Temporal изначально продуман как «иммутабельный»: это упрощает понимание и совместную работу в больших командах, где можно неожиданно «сломать» общий объект даты. И, конечно, это всё лишь начало — как только техническая спецификация окончательно устаканится, будут улучшаться и возможности форматирования, и вспомогательные методы.
Ссылки и ресурсы
Следите за обновлениями, потому что будущее, где даты и время в JavaScript перестают быть головной болью, уже рядом!