Temporal API достигает Stage 4: конец эре проблем с датами

[hannadev]

Спустя девять лет упорной работы Temporal API наконец достиг Stage 4 на TC39 и готов стать частью стандарта ECMAScript. Это означает, что встроенный JavaScript Date, который мучил разработчиков с 1995 года, получит наконец-то достойную замену. Хорошая новость — использовать Temporal можно уже сейчас, не дожидаясь официального релиза.

Что это дает вам как разработчику? Никаких больше головоломок с временными зонами, иммутабельные объекты дат, поддержка разных календарных систем и точность до наносекунд. Это не просто улучшение — это революция в том, как JavaScript работает со временем.

Почему Date был таким кошмаром

Оригинальный Date объект — это наследие 90-х, когда веб был намного проще. Главные проблемы, которые преследовали разработчиков все эти годы, хорошо известны каждому, кто когда-либо работал с датами. Объект Date был мутабелен, то есть вы могли случайно изменить дату после её создания. Он не понимал временные зоны толком — максимум знал локальное время пользователя или UTC. Если нужно было работать с датой без времени или временем без даты, вас ждали костыли и обходные пути.

Кроме того, API был просто неудобным. Например, месяцы считаются с нуля (январь — это 0, февраль — это 1), что постоянно приводило к ошибкам. Парсер дат работал неправильно и давал непредсказуемые результаты в разных браузерах. Миллионы разработчиков установили себе Moment.js, Day.js или Luxon просто потому, что встроенное решение было практически непригодным для реальных проектов.

Вот чем это выборачивалось:

• Отсутствие иммутабельности - случайные изменения объекта приводили к сложным багам
• Слабая поддержка временных зон - только локальное время и UTC
• Неправильный парсинг - одна и та же строка могла обработаться по-разному
• Неудобный API - месяцы с нуля, методы с запутанными названиями
• Отсутствие разделения типов - невозможно отдельно работать с датой или временем

Что принёс Temporal

Тemporal решает все перечисленные проблемы систематически. Это не просто исправление, а переосмысление того, как должно работать время в языке программирования. Объекты Temporal иммутабельны по умолчанию — каждая операция возвращает новый объект, оригинал остается нетронутым. Это избавляет вас от целого класса багов и делает код более предсказуемым.

Временные зоны теперь обработаны достойно. Вы можете явно указать часовой пояс, работать с ним, преобразовывать между зонами — всё это логично и безопасно. Но главное удобство — это разделение типов. Теперь есть отдельные объекты для разных сценариев: PlainDate для работы только с датой, PlainTime для работы только с временем, PlainDateTime для комбинации, ZonedDateTime для дат с временными зонами и Instant для конкретного момента на временной шкале.

Тemporal поддерживает не только григорианский календарь, но и другие системы - еврейский, исламский, буддийский и другие. Это критично важно для приложений, которые работают с разными культурами и регионами. Кроме того, точность доведена до наносекунд, что пригодится для высокоточных научных и финансовых расчётов.

Ключевые возможности:

• Иммутабельные объекты - все методы возвращают новый объект
• Явная работа с временными зонами - используется IANA база данных
• Разделение типов дат и времени - отдельные объекты для разных сценариев
• Поддержка международных календарей - еврейский, исламский, буддийский и другие
• Наносекундная точность - для критичных приложений
• RFC 9557 стандарт сериализации - правильное хранение информации о зонах и календарях

Текущая поддержка браузерами

Что замечательно - Temporal не нужно ждать до официального выхода. Его уже можно использовать прямо сейчас на актуальных браузерах и инструментах. Firefox получил Temporal в версии 139 ещё в мае прошлого года. Chrome и Edge оба поддерживают его с версии 144, выпущенной в январе этого года. TypeScript 6.0 beta тоже готов работать с Temporal.

Для тех, кто не может ждать полной поддержки, есть полифилы - ссылаемый полифил от самих авторов предложения позволяет использовать Temporal даже в старых браузерах, хотя с некоторыми ограничениями по производительности. Safari находится в зоне частичной поддержки через Technology Preview, Node.js версии 26 также будет иметь поддержку.

Таблица текущей поддержки:

Браузер/Платформа	Версия	Статус
Firefox	139+	Полная поддержка
Chrome	144+	Полная поддержка
Edge	144+	Полная поддержка
Safari	Technology Preview	Частичная поддержка
TypeScript	6.0+	Полная поддержка
Node.js	26+	Полная поддержка
Полифил	Доступен	Для старых браузеров

Масштаб изменений

Чтобы понять, насколько серьёзно это изменение, посмотрите на цифры. Temporal поставляется с примерно 4500 тестами из набора test262, которые проверяют его корректность. Для сравнения - оригинальный Date объект имеет всего 594 теста. Это означает, что новое решение на порядок более тщательно разработано и протестировано.

Тemporal - самое большое предложение за всю историю JavaScript. Спецификация больше, чем весь ECMA-402 (стандарт интернационализации). Это привело к техническим вызовам при реализации - не каждый разработчик может в одиночку разобраться с V8 или SpiderMonkey достаточно хорошо, чтобы реализовать такое. Поэтому авторы создали временный Rust-реализацию для прототипирования, что позволило совместно работать над спецификацией без необходимости глубокого понимания внутренностей браузерных движков.

Цифры, говорящие сами за себя:

• 9 лет разработки - с начала и до Stage 4
• 4500 тестов - в 7,5 раз больше, чем у Date
• Поддержка 20+ календарных систем - охватывает большинство мировых традиций
• Наносекундная точность - против миллисекунд в Date
• Иммутабельность по умолчанию - предотвращает целый класс ошибок

Как это повлияет на экосистему

Уже сейчас видно, как реагирует сообщество. Библиотеки вроде Moment.js, которые когда-то были спасением, теперь постепенно становятся менее нужными. День.js, Luxon и date-fns не исчезнут, но их роль изменится. Вместо того чтобы быть фундаментом, на котором строятся приложения, они станут удобными обёртками и наборами формата для конкретных задач.

Фреймворки и библиотеки будут постепенно мигрировать на Temporal. Это не произойдет мгновенно - многие компании продолжат использовать текущие решения из-за необходимости поддерживать старые браузеры. Но со временем Temporal станет стандартом де-факто. Те, кто работает с scheduling, аналитикой или финансовыми приложениями, получат значительный прирост производительности и надёжности.

Ожидаемые изменения в экосистеме:

• Постепенная миграция библиотек - большинство перейдут на Temporal в течение года-двух
• Обновление документации - MDN и другие ресурсы уже обновляют справку
• Новые инструменты - появятся специализированные бибилиотеки для работы с Temporal
• Улучшение производительности - встроенное решение быстрее, чем внешние библиотеки
• Лучше типизация - TypeScript будет иметь встроенную поддержку

Что ещё предстоит сделать

He смотря на то что Temporal достиг Stage 4, работа не заканчивается. Теперь предстоит интегрировать его с остальной веб-экосистемой. За много лет существования Date создалось множество API, которые работают с ним или вокруг него. Все эти API должны стать совместимы с Temporal объектами. Это большая и кропотливая работа, которая будет занимать разработчиков ещё долго.

Кроме того, нужно убедиться, что Temporal хорошо работает не только в браузерах, но и в Node.js, Deno и других JavaScript движках. Нужно убедить производителей мобильных браузеров внедрить поддержку - это часто бывает узким местом, так как мобильные браузеры отстают в поддержке новых фич. Наконец, сообщество должно выработать best practices для использования Temporal в различных сценариях.

Последний момент времени

Время показало, что JavaScript сообщество способно упорно работать над улучшением языка, даже когда задача кажется неподъёмной. Девять лет - это не просто длительный период, это свидетельство глубокой вовлеченности разработчиков, архитекторов браузеров и авторов стандартов. Temporal API - результат этого колоссального труда, и теперь каждый разработчик может ощутить результаты.

Есть ещё много интересного в деталях - например, как именно работает сериализация с информацией о временных зонах через RFC 9557, как обрабатываются граничные случаи при переходах на летнее/зимнее время, как оптимально работать с историческими данными. Но главное - фундамент готов, и дальше это зависит от того, как быстро разработчики начнут использовать Temporal в своих проектах.