TemporalLimited availability

The Temporal API allows you to work with dates, times, time zones, and durations. It is more powerful than the Date API.

Not yet supported in all major browsers — check the table and provide a fallback.

How to use ↓Compare browsers

Browser support

DesktopChrome

1–143Not supported

144+Supportedsince Jan 13, 2026

Current: 155

Edge

12–143Not supported

144+Supportedsince Jan 21, 2026

Current: 154

Firefox

1–138Not supported

139+Supportedsince May 27, 2025

Current: 157

Safari

✕Not supportedup to 27

Current: 27

MobileChrome Android

18–143Not supported

144+Supportedsince Jan 13, 2026

Current: 155

Firefox Android

4–138Not supported

139+Supportedsince May 27, 2025

Current: 157

Safari iOS

✕Not supportedup to 27

Current: 27

How to use

Not supported in Safari, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.

Example

const today = Temporal.Now.plainDateISO();
const due = today.add({ days: 30 });
const meeting = Temporal.ZonedDateTime.from("2026-10-14T09:00[Asia/Kolkata]");
console.log(due.toString(), meeting.withTimeZone("Europe/London").toString());

Feature detection

JS · check before using

if (typeof Temporal !== "undefined") {
  // Temporal is available
}

Documentation (MDN)

Specification

tc39.es/proposal-temporal ↗

Usage share

caniuse.com/temporal ↗

Sub-features

Support for each part of the feature (243). The overall table above shows when the whole feature works.

Sub-feature	Chrome	Edge	Firefox	Safari	Chrome Android	Firefox Android	Safari iOS
Date.toTemporalInstant	144	144	139	✕	144	139	✕
Temporal	144	144	139	✕	144	139	✕
Temporal.Duration	144	144	139	✕	144	139	✕
Temporal.Duration.Duration	144	144	139	✕	144	139	✕
Temporal.Duration.abs	144	144	139	✕	144	139	✕
Temporal.Duration.add	144	144	139	✕	144	139	✕
Temporal.Duration.blank	144	144	139	✕	144	139	✕
Temporal.Duration.compare	144	144	139	✕	144	139	✕
Temporal.Duration.days	144	144	139	✕	144	139	✕
Temporal.Duration.from	144	144	139	✕	144	139	✕
Temporal.Duration.hours	144	144	139	✕	144	139	✕
Temporal.Duration.microseconds	144	144	139	✕	144	139	✕
Temporal.Duration.milliseconds	144	144	139	✕	144	139	✕
Temporal.Duration.minutes	144	144	139	✕	144	139	✕
Temporal.Duration.months	144	144	139	✕	144	139	✕
Temporal.Duration.nanoseconds	144	144	139	✕	144	139	✕
Temporal.Duration.negated	144	144	139	✕	144	139	✕
Temporal.Duration.round	144	144	139	✕	144	139	✕
Temporal.Duration.seconds	144	144	139	✕	144	139	✕
Temporal.Duration.sign	144	144	139	✕	144	139	✕

Show 223 more

Sub-feature	Chrome	Edge	Firefox	Safari	Chrome Android	Firefox Android	Safari iOS
Temporal.Duration.subtract	144	144	139	✕	144	139	✕
Temporal.Duration.toJSON	144	144	139	✕	144	139	✕
Temporal.Duration.toLocaleString	144	144	139	✕	144	139	✕
Temporal.Duration.toString	144	144	139	✕	144	139	✕
Temporal.Duration.total	144	144	139	✕	144	139	✕
Temporal.Duration.valueOf	144	144	139	✕	144	139	✕
Temporal.Duration.weeks	144	144	139	✕	144	139	✕
Temporal.Duration.with	144	144	139	✕	144	139	✕
Temporal.Duration.years	144	144	139	✕	144	139	✕
Temporal.Instant	144	144	139	✕	144	139	✕
Temporal.Instant.Instant	144	144	139	✕	144	139	✕
Temporal.Instant.add	144	144	139	✕	144	139	✕
Temporal.Instant.compare	144	144	139	✕	144	139	✕
Temporal.Instant.epochMilliseconds	144	144	139	✕	144	139	✕
Temporal.Instant.epochNanoseconds	144	144	139	✕	144	139	✕
Temporal.Instant.equals	144	144	139	✕	144	139	✕
Temporal.Instant.from	144	144	139	✕	144	139	✕
Temporal.Instant.fromEpochMilliseconds	144	144	139	✕	144	139	✕
Temporal.Instant.fromEpochNanoseconds	144	144	139	✕	144	139	✕
Temporal.Instant.round	144	144	139	✕	144	139	✕
Temporal.Instant.since	144	144	139	✕	144	139	✕
Temporal.Instant.subtract	144	144	139	✕	144	139	✕
Temporal.Instant.toJSON	144	144	139	✕	144	139	✕
Temporal.Instant.toLocaleString	144	144	139	✕	144	139	✕
Temporal.Instant.toString	144	144	139	✕	144	139	✕
Temporal.Instant.toZonedDateTimeISO	144	144	139	✕	144	139	✕
Temporal.Instant.until	144	144	139	✕	144	139	✕
Temporal.Instant.valueOf	144	144	139	✕	144	139	✕
Temporal.Now	144	144	139	✕	144	139	✕
Temporal.Now.instant	144	144	139	✕	144	139	✕
Temporal.Now.plainDateISO	144	144	139	✕	144	139	✕
Temporal.Now.plainDateTimeISO	144	144	139	✕	144	139	✕
Temporal.Now.plainTimeISO	144	144	139	✕	144	139	✕
Temporal.Now.timeZoneId	144	144	139	✕	144	139	✕
Temporal.Now.zonedDateTimeISO	144	144	139	✕	144	139	✕
Temporal.PlainDate	144	144	139	✕	144	139	✕
Temporal.PlainDate.PlainDate	144	144	139	✕	144	139	✕
Temporal.PlainDate.add	144	144	139	✕	144	139	✕
Temporal.PlainDate.calendarId	144	144	139	✕	144	139	✕
Temporal.PlainDate.compare	144	144	139	✕	144	139	✕
Temporal.PlainDate.day	144	144	139	✕	144	139	✕
Temporal.PlainDate.dayOfWeek	144	144	139	✕	144	139	✕
Temporal.PlainDate.dayOfYear	144	144	139	✕	144	139	✕
Temporal.PlainDate.daysInMonth	144	144	139	✕	144	139	✕
Temporal.PlainDate.daysInWeek	144	144	139	✕	144	139	✕
Temporal.PlainDate.daysInYear	144	144	139	✕	144	139	✕
Temporal.PlainDate.equals	144	144	139	✕	144	139	✕
Temporal.PlainDate.era	144	144	139	✕	144	139	✕
Temporal.PlainDate.eraYear	144	144	139	✕	144	139	✕
Temporal.PlainDate.from	144	144	139	✕	144	139	✕
Temporal.PlainDate.inLeapYear	144	144	139	✕	144	139	✕
Temporal.PlainDate.month	144	144	139	✕	144	139	✕
Temporal.PlainDate.monthCode	144	144	139	✕	144	139	✕
Temporal.PlainDate.monthsInYear	144	144	139	✕	144	139	✕
Temporal.PlainDate.since	144	144	139	✕	144	139	✕
Temporal.PlainDate.subtract	144	144	139	✕	144	139	✕
Temporal.PlainDate.toJSON	144	144	139	✕	144	139	✕
Temporal.PlainDate.toLocaleString	144	144	139	✕	144	139	✕
Temporal.PlainDate.toPlainDateTime	144	144	139	✕	144	139	✕
Temporal.PlainDate.toPlainMonthDay	144	144	139	✕	144	139	✕
Temporal.PlainDate.toPlainYearMonth	144	144	139	✕	144	139	✕
Temporal.PlainDate.toString	144	144	139	✕	144	139	✕
Temporal.PlainDate.toZonedDateTime	144	144	139	✕	144	139	✕
Temporal.PlainDate.until	144	144	139	✕	144	139	✕
Temporal.PlainDate.valueOf	144	144	139	✕	144	139	✕
Temporal.PlainDate.weekOfYear	144	144	139	✕	144	139	✕
Temporal.PlainDate.with	144	144	139	✕	144	139	✕
Temporal.PlainDate.withCalendar	144	144	✕	✕	144	✕	✕
Temporal.PlainDate.year	144	144	139	✕	144	139	✕
Temporal.PlainDate.yearOfWeek	144	144	139	✕	144	139	✕
Temporal.PlainDateTime	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.PlainDateTime	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.add	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.calendarId	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.compare	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.day	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.dayOfWeek	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.dayOfYear	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.daysInMonth	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.daysInWeek	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.daysInYear	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.equals	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.era	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.eraYear	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.from	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.hour	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.inLeapYear	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.microsecond	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.millisecond	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.minute	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.month	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.monthCode	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.monthsInYear	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.nanosecond	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.round	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.second	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.since	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.subtract	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.toJSON	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.toLocaleString	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.toPlainDate	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.toPlainTime	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.toString	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.toZonedDateTime	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.until	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.valueOf	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.weekOfYear	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.with	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.withCalendar	144	144	✕	✕	144	✕	✕
Temporal.PlainDateTime.withPlainTime	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.year	144	144	139	✕	144	139	✕
Temporal.PlainDateTime.yearOfWeek	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.PlainMonthDay	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.calendarId	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.day	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.equals	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.from	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.monthCode	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.toJSON	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.toLocaleString	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.toPlainDate	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.toString	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.valueOf	144	144	139	✕	144	139	✕
Temporal.PlainMonthDay.with	144	144	139	✕	144	139	✕
Temporal.PlainTime	144	144	139	✕	144	139	✕
Temporal.PlainTime.PlainTime	144	144	139	✕	144	139	✕
Temporal.PlainTime.add	144	144	139	✕	144	139	✕
Temporal.PlainTime.compare	144	144	139	✕	144	139	✕
Temporal.PlainTime.equals	144	144	139	✕	144	139	✕
Temporal.PlainTime.from	144	144	139	✕	144	139	✕
Temporal.PlainTime.hour	144	144	139	✕	144	139	✕
Temporal.PlainTime.microsecond	144	144	139	✕	144	139	✕
Temporal.PlainTime.millisecond	144	144	139	✕	144	139	✕
Temporal.PlainTime.minute	144	144	139	✕	144	139	✕
Temporal.PlainTime.nanosecond	144	144	139	✕	144	139	✕
Temporal.PlainTime.round	144	144	139	✕	144	139	✕
Temporal.PlainTime.second	144	144	139	✕	144	139	✕
Temporal.PlainTime.since	144	144	139	✕	144	139	✕
Temporal.PlainTime.subtract	144	144	139	✕	144	139	✕
Temporal.PlainTime.toJSON	144	144	139	✕	144	139	✕
Temporal.PlainTime.toLocaleString	144	144	139	✕	144	139	✕
Temporal.PlainTime.toString	144	144	139	✕	144	139	✕
Temporal.PlainTime.until	144	144	139	✕	144	139	✕
Temporal.PlainTime.valueOf	144	144	139	✕	144	139	✕
Temporal.PlainTime.with	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.PlainYearMonth	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.add	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.calendarId	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.compare	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.daysInMonth	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.daysInYear	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.equals	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.era	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.eraYear	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.from	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.inLeapYear	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.month	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.monthCode	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.monthsInYear	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.since	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.subtract	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.toJSON	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.toLocaleString	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.toPlainDate	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.toString	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.until	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.valueOf	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.with	144	144	139	✕	144	139	✕
Temporal.PlainYearMonth.year	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.ZonedDateTime	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.add	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.calendarId	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.compare	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.day	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.dayOfWeek	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.dayOfYear	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.daysInMonth	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.daysInWeek	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.daysInYear	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.epochMilliseconds	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.epochNanoseconds	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.equals	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.era	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.eraYear	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.from	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.getTimeZoneTransition	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.hour	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.hoursInDay	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.inLeapYear	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.microsecond	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.millisecond	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.minute	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.month	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.monthCode	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.monthsInYear	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.nanosecond	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.offset	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.offsetNanoseconds	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.round	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.second	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.since	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.startOfDay	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.subtract	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.timeZoneId	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.toInstant	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.toJSON	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.toLocaleString	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.toPlainDate	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.toPlainDateTime	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.toPlainTime	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.toString	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.until	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.valueOf	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.weekOfYear	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.with	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.withCalendar	144	144	✕	✕	144	✕	✕
Temporal.ZonedDateTime.withPlainTime	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.withTimeZone	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.year	144	144	139	✕	144	139	✕
Temporal.ZonedDateTime.yearOfWeek	144	144	139	✕	144	139	✕