re:re:actable
Урок 072 минуты чтения

Что такое Temporal API?

На этой странице
Кратко

Temporal API - современный набор объектов для работы с датами, временем, часовыми поясами и длительностями, задуманный как замена проблемному Date.

Вопрос

Зачем нужен Temporal API, если в JavaScript уже есть Date?

Определение

Temporal решает многие проблемы старого Date: мутабельность, неоднозначные часовые пояса, неудобную арифметику дат и смешивание разных смыслов времени в одном объекте.

Temporal разделяет разные понятия:

  • календарная дата;
  • время без даты;
  • точный момент времени;
  • дата и время в часовом поясе;
  • длительность.

Важный статус поддержки

Temporal - современный API, но его доступность зависит от браузера и версии окружения. Перед использованием в проекте нужно проверить поддержку или подключить polyfill.

Пример PlainDate

const date = Temporal.PlainDate.from('2026-08-03');
 
const nextWeek = date.add({ days: 7 });
 
console.log(nextWeek.toString()); // '2026-08-10'

PlainDate описывает календарную дату без времени и часового пояса.

Пример Instant

const instant = Temporal.Now.instant();
 
console.log(instant.toString());

Instant описывает точный момент времени.

Date vs Temporal

DateTemporal
один объект для разных задачотдельные типы для разных задач
мутабельныйиммутабельный
неудобная работа с time zoneявная работа с time zone
старый APIболее предсказуемый API

Что важно помнить

  • Temporal решает проблемы Date: изменяемость, месяцы с нуля, неудобные часовые пояса.
  • Типы разделены по смыслу: PlainDate, PlainTime, ZonedDateTime, Instant, Duration.
  • Объекты Temporal неизменяемы — методы возвращают новые значения.
  • Поддержка браузерами еще неполная; пока используют полифил или date-fns/dayjs.

Мини-шпаргалка

Temporal.Now.instant();
Temporal.PlainDate.from('2026-08-03');
Temporal.Duration.from({ hours: 2 });

Документация

MDN: Temporal, TC39: Temporal documentation.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам