Temporal API: стандартизация дат и времени в JavaScript 2026

[hannadev]

Temporal API меняет подход к датам и времени в JavaScript. Это стандартная замена старому объекту Date, который часто подводит из-за неявных таймзон и мутаций. С Temporal разработчики получают иммутабельные объекты, точную работу с часовыми поясами и календарями. Теперь ошибки с датами уходят в прошлое, а код становится предсказуемым.

Зачем это нужно? Старый Date парсит строки непредсказуемо, мутирует себя и игнорирует нюансы вроде перехода на летнее время. Temporal решает эти проблемы нативно в ES2026. Поддержка уже есть в Chrome 144+, Firefox 139+ и Deno. Это упрощает жизнь фронтенд-разработчикам и делает приложения надежными.

Проблемы Date и как Temporal их исправляет

Объект Date в JavaScript служит десятилетиями, но его слабости известны всем. Он предполагает локальную таймзону, если не указано иное, что приводит к ошибкам в международных проектах. Добавление месяцев может сдвинуть дату из-за разной длины - например, 31 января плюс месяц станет 3 марта в некоторых случаях. Парсинг строк вроде “2026-03-08” зависит от браузера и локали.

Temporal вводит строгие типы для разных сценариев: PlainDate для дат без времени, ZonedDateTime для моментов с таймзоной. Все объекты иммутабельны - методы возвращают новые экземпляры, не меняя оригинал. Поддержка ISO 8601 унифицирована, а наносекундная точность покрывает даже логи сервера. Это делает код устойчивым к багам.

Вот ключевые улучшения:

• Иммутабельность: Нет неожиданных мутаций, как в Date.setMonth().
• Таймзоны из коробки: Указывайте ‘Europe/Berlin’ явно, без хаков.
• Разделение типов: PlainTime для времени, Duration для интервалов, Instant для UTC-точек.
• Расширенный диапазон: От года 1 до миллиона, с поддержкой не-григорианских календарей.

Сравнение Date и Temporal
Аспект	Date	Temporal
Иммутабельность	Мутабельный	Иммутабельный
Таймзоны	Неявные, локальные	Явные, first-class
Парсинг	Зависит от локали	Стандартизированный ISO
Точность	Миллисекунды	Наносекунды

Основные классы Temporal API

Temporal - это не один класс, а пространство имен с набором объектов. Temporal.Now дает текущие значения вроде plainDateISO() для сегодняшней даты. PlainDate представляет дату без времени и таймзоны, идеально для дней рождения или событий. ZonedDateTime комбинирует дату, время и пояс - для встреч или дедлайнов.

Пример: создаем дату встречи в Берлине и добавляем месяц. С Date результат зависит от локали, с Temporal - предсказуем. Duration вычисляет интервалы точно, учитывая високосные годы. Instant фиксирует момент в UTC, без влияния поясов - полезно для логов. Все это работает без библиотек вроде Moment.js или date-fns.

Рассмотрим типы подробнее:

1. Temporal.PlainDate: Дата без времени. Temporal.PlainDate.from('2026-03-08').
2. Temporal.ZonedDateTime: Дата-время с таймзоной. Temporal.ZonedDateTime.from('2026-03-08T10:00[Europe/Moscow]').
3. Temporal.Duration: Интервал. meeting.add({ months: 1 }) возвращает новый объект.
4. Temporal.Instant: UTC-точка. Temporal.Now.instant() для серверных меток.

// Date: мутация и сюрпризы
const meeting = new Date(2026, 2, 31, 10, 0); // 31 марта?meeting.setMonth(3);console.log(meeting);// Зависит от локали

// Temporal: четко и иммутабельно
const meetingTemporal = Temporal.ZonedDateTime.from('2026-03-31T10:00[Europe/Berlin]');const next = meetingTemporal.add({ months: 1 });console.log(next.toString()); // 2026-04-30T10:00+02:00[Europe/Berlin]

Практические примеры использования

В реальных проектах Temporal упрощает задачи вроде подсчета дней до события или форматирования расписаний. Текущая дата: Temporal.Now.plainDateISO('America/New_York') для разных поясов. Добавление дней: today.add({ days: 7 }) не сломается на концах месяца. Разница во времени: endTime.since(startTime) дает Duration с часами и минутами.

Для мобильных приложений или фронтенда это спасение - нет нужды в полифиллах для новых браузеров. В 2026 году стандарт в ES2026, полифилл @js-temporal/polyfill для старых. Форматирование локализовано, календари вроде японского или исламского поддерживаются нативно. Код чище, тесты проще.

Простые сценарии:

• Текущая дата: Temporal.Now.plainDateISO() - ‘2026-03-08’.
• Рабочий день: start = Temporal.PlainTime.from('09:00'); duration = end.since(start);.
• Следующий месяц: today.add({ months: 1 }).toString().

Задача	Date-код	Temporal-код
Текущая дата	new Date()	Temporal.Now.plainDateISO()
+1 месяц	setMonth(getMonth()+1)	add({ months: 1 })
Разница	Ручной расчет	since()

Temporal в production и миграция

К 2026 году Temporal - стандарт для новых проектов. Поддержка в движках полная, кроме Safari в preview. Полифилл обеспечивает кросс-браузерность. Миграция проста: замените new Date() на Temporal.Now, а setDate на add(). Библиотеки устаревают - date-fns и Moment под угрозой.

Тестируйте в Chrome DevTools или Node.js с флагом. Для интернациональных apps укажите таймзону всегда. Нюансы: старые строки парсятся через .from(), но проверяйте формат. Это шаг к предсказуемому JS.

Что Temporal еще не покрывает полностью

Temporal решает 90% задач с датами, но редкие календари требуют доработок. Поддержка исторических изменений таймзон растет. В старых браузерах полагайтесь на полифилл, пока Safari не догонит. Стоит поэкспериментировать с Duration для сложных интервалов вроде ‘P1Y2M3DT4H’. Дальше ждем интеграции в фреймворки.