Temporal API в JavaScript 2026: замена Date и новые возможности

hannadev

JavaScript наконец-то получает нормальный способ работать с датами и временем. Объект Date, который разработчики ненавидят уже два десятилетия, уходит в прошлое — на его место приходит Temporal API. Эта новая система решает десятки проблем, с которыми мы боролись годами: багов с часовыми поясами, неожиданных сдвигов при манипуляции датами, невозможности нормально парсить и форматировать время.

В начале 2026 года Temporal уже достиг четвёртой стадии стандартизации TC39 и вот-вот станет частью официального стандарта ECMAScript. Chrome, Edge и Firefox уже поддерживают API, а разработчики могут использовать его в боевых условиях. Пора разобраться, что это такое, почему это меняет игру и как начать внедрять в свои проекты.

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

Объект Date появился в JavaScript в 1995 году и с тех пор почти не менялся. Проблема в том, что за 30 лет всё изменилось, а Date остался жить в каменном веке. Когда вы создаёте новую дату через конструктор, неявно используется локальная временная зона браузера — это источник бесконечных багов. Добавьте месяц к дате через setMonth(), и объект изменится на месте (мутирует), что ломает реактивное состояние во фронтенде. Попробуйте сравнить две даты — а Date не понимает концепцию неизменяемости, поэтому сравнение часто срезается на тонких местах.

Моментjs и date-fns давно стали стандартом в индустрии именно потому, что они спасают нас от Date. Но это добавляетзависимость, увеличивает размер бандла и усложняет экосистему. Нужно было встроить всё это в сам язык.

Вот список основных бед старого подхода:

Неявные временные зоны - дата привязана к локальной ТЗ браузера, что вызывает неожиданные смещения
Мутирующие объекты - setMonth(), setDate() меняют исходный объект, ломая чистоту функций
Слабая поддержка часовых поясов - практически невозможно работать с несколькими ТЗ одновременно
Плохой парсинг - строка “2026-01-31” парсится по-разному в зависимости от браузера
Отсутствие типизации - Date не различает между датой, временем, моментом во времени
Сложность с календарями - на ТЗ gregorian, а что если нужна японская или буддийская система?

Temporal API: как это работает

Temporalный API полностью переосмысляет работу с датами и временем. Вместо одного объекта Date, который пытается быть всем на свете, появилось несколько специализированных типов. Каждый из них отвечает за конкретную задачу — это делает код ясным и понятным.

Второй ключевой момент — неизменяемость. Когда вы добавляете месяц к дате, Temporal не меняет исходный объект, а возвращает новую дату. Это полностью совпадает с принципами функционального программирования и работает отлично с React, Vue и другими современными фреймворками. Плюс, Temporal понимает и явно обрабатывает часовые пояса — они не прячутся в подвале, а становятся полноправной частью API.

Основные типы Temporal, которые вам понадобятся:

Тип	Назначение	Пример
Temporal.PlainDate	Только дата, без времени	2026-05-21
Temporal.PlainTime	Только время, без даты	14:30:00
Temporal.PlainDateTime	Дата и время (без ТЗ)	2026-01-24 14:30:00
Temporal.ZonedDateTime	Дата, время и часовой пояс	2026-02-28T10:00:00+01:00[Europe/Berlin]
Temporal.PlainYearMonth	Год и месяц	2026-05
Temporal.PlainMonthDay	Месяц и день	05-01

Сравнение: Date vs Temporal на примере

Давайте посмотрим на конкретном примере, почему старый подход ломается. Представьте, что вам нужно запланировать встречу на 31 января 2026 в 10:00 по берлинскому времени, а потом добавить месяц.

С обычным Date:

// Встреча 31 января 2026 в 10:00 (временная зона неявная!)
const meetingDate = new Date(2026, 0, 31, 10, 0);

// Добавляем 1 месяц (мутирует объект)
meetingDate.setMonth(meetingDate.getMonth() + 1);

console.log('Date:', meetingDate.toString());
// Результат зависит от локальной ТЗ вашего браузера
// Может быть неожиданный сдвиг даты

С Temporal API:

// Та же встреча, но явно в Europe/Berlin
const meetingTemporal = new Temporal.ZonedDateTime(
  2026, 1, 31,
  10, 0, 0, 0, 0, 0,
  'Europe/Berlin'
);

// Добавляем 1 месяц (не мутирует объект)
const nextMonth = meetingTemporal.add({ months: 1 });

console.log('Temporal:', nextMonth.toString());
// 2026-02-28T10:00:00+01:00[Europe/Berlin]

Видите разницу? В Temporal всё явно: мы указываем точную временную зону, не получаем неожиданных сдвигов, новая дата возвращается отдельным объектом. Никаких тайных багов.

Ключевые преимущества Temporal

Теперь разберём, чем конкретно Temporal круче:

Неизменяемые объекты - операции вроде add(), subtract() возвращают новый объект, не меняя исходный
Полная поддержка UTC и часовых поясов - можно явно указать любую ТЗ, нет неожиданных переходов
Валидация дат на лету - если вы попытаетесь создать 31 февраля, API сразу вас остановит
Разделение типов по смыслу - дата, время, момент во времени, интервал и календарь это разные объекты
Поддержка различных календарей - не только gregorian, но и японский, буддийский и другие
Предсказуемое поведение - нет скрытых побочных эффектов и зависимости от локали браузера

Поддержка в браузерах: где мы стоим

Хорошая новость: Temporal уже работает в основных браузерах. Chrome, Edge и Firefox полностью поддерживают API, и если вы пишете код сегодня, можете начинать использовать Temporal без полифиллов.

Badnewsвсё не так радужно с Safari. По состоянию на март 2026 года Apple не объявила точную дату стабильного релиза. Однако реализация активно разрабатывается и её уже можно тестировать в Safari Technology Preview — нужно включить флаг --use-temporal при запуске браузера.

Если вам нужна поддержка старых браузеров, есть полифиллы, но имейте в виду, что они не могут полностью эмулировать Temporal из-за особенностей JavaScript. С Babel можно спуститься до Chrome 57, но это при условии, что Intl API доступен.

Текущий статус поддержки:

Chrome - полная поддержка
Edge - полная поддержка
Firefox - полная поддержка
Safari - в разработке, доступен в Technology Preview
Полифиллы - доступны для старых браузеров (с ограничениями)

Что ещё нового в ECMAScript 2026

Temporal не единственное, что принесла спецификация 2026 года. Есть ещё несколько полезных фич, которые облегчат жизнь разработчикам.

using и await using - новые ключевые слова для автоматического управления ресурсами. Они работают по принципу finally блоков в других языках: когда блок кода заканчивается, ресурсы автоматически освобождаются. Это решает проблему забытых cleanup-функций в асинхронном коде.

Array.fromAsync() - создание массивов из асинхронных итераторов. Вместо сложных конструкций с for await вы просто вызываете Array.fromAsync() и получаете готовый массив. Удобно для работы с API и потоками данных.

Error.isError() - быстрая проверка, является ли объект ошибкой. Раньше приходилось писать instanceof Error или проверять наличие свойств. Теперь есть стандартный метод.

Методы to/fromHex() для Uint8Array - упрощение работы с шестнадцатеричными данными. Вместо ручного кодирования и декодирования используете встроенные методы.

Все эти фичи уже находятся в Stage 4 (финальная стадия перед включением в стандарт) и частично поддерживаются браузерами к марту 2026.

Как начать использовать Temporal

Если вы готовы переходить на Temporal, вот с чего начать. Первое - не надо переписывать весь код сразу. Можно постепенно заменять Date на Temporal по мере рефакторинга функций. Второе - используйте Temporal.Now для получения текущего времени вместо new Date().

// Вместо:
const today = new Date();

// Пишите:
const today = Temporal.Now.plainDateISO();

Третье - изучите методы Temporal.Now, которые возвращают текущее время в разных форматах. Есть методы для получения текущей даты, времени, момента во времени - всё в одном месте.

console.log(Temporal.Now);
// Результат:
// {
//   instant: function instant(),
//   plainDateISO: function plainDateISO(),
//   plainDateTimeISO: function plainDateTimeISO(),
//   plainTimeISO: function plainTimeISO(),
//   timeZoneId: function timeZoneId(),
//   zonedDateTimeISO: function zonedDateTimeISO()
// }

Четвёртое - не забывайте про неизменяемость. Всегда используйте результат методов add() и subtract(), а не предполагайте, что исходный объект изменился.

const today = Temporal.Now.plainDateISO();
const tomorrow = today.add({ days: 1 }); // Создает новый объект

console.log(`Tomorrow will be ${tomorrow}. Today is ${today}.`);
// Tomorrow will be 2026-01-01. Today is 2025-12-31.

Интеграция с HTML формами

Есть ещё одна интересная область - интеграция Temporal с HTML формами. Элементы input типа date, time, week и month работали с Date через свойство valueAsDate. Но Date и Temporal - разные системы, конвертировать между ними неудобно.

Сейчас стандарт рассматривает введение нового свойства valueAsTemporal для этих элементов. Это будет намного удобнее, чем работать через строковое значение и ручное парсинг через Temporal.PlainDate.from(). Однако эта фича ещё в статусе proposal и потребует времени на реализацию.

Пока что оптимальный подход - работать со строковым значением input и парсить через Temporal:

const dateInput = document.querySelector('input[type="date"]');
const tempDate = Temporal.PlainDate.from(dateInput.value);

Что ждёт JavaScript дальше

Temporal API - это не финальная точка. Разработчики ECMAScript продолжают работать над улучшением работы с датами и временем. На горизонте есть предложения по интеграции с HTML формами, улучшению парсинга и форматирования, расширению поддержки редких календарных систем.

Основной посыл простой: JavaScript наконец-то вырос из новичка, который пугался сложных операций с датами, в язык, который может конкурировать с Python, Java и другими зрелыми платформами по удобству работы со временем. Это не революция, а обычная эволюция - язык просто поправляет то, что должно было быть изначально.