JavaScript Temporal Tutorial
Temporal Study Path
Learn JavaScript Temporal in the Right Order.
What is JavaScript Temporal?
Temporal is the new standard for date and time in JavaScript.
New Temporal objects was designed to replace the old Date object.
Unlike legacy Date, Temporal objects are immutable and provide first-class support for time zones, daylight saving time, date arithmetic and non-Gregorian calendars.
Temporal vs Date
Compare JavaScript Temporal and JavaScrip Date.
Learn the differences in:
- Mutation
- Time zones
- DST handling
- Date math
Learn why Temporal is the modern alternative to Date.
Temporal.Duration
The Temporal.Duration object represents a length of time.
Example: 7 days and 1 hour.
The Temporal.Duration object includes these properties:
years, months, weeks, days, hours, minutes, seconds, milliseconds, and nanoseconds.
It is used to perform precise date and time arithmetic (e.g. add and subtract) without the bugs and complexity associated with the old JavaScript Date object.
- How to use JavaScript Temporal.Duration
- How to represent and calculate lengths of time
- How to add and subtract days, hours, and months more safely
Temporal.Instant
A Temporal.Instant represents an exact moment in time.
It is similar to a timestamp and is always stored in UTC.
Learn how to use JavaScript Temporal.Instant to work with exact moments in time.
Compare Instants, convert from timestamps, and replace Date.now().
Temporal.PlainDate
A Temporal.PlainDate object represents a calendar date without a time.
A Temporal.PlainDate is typically in ISO 8601 format ("2026-05-01").
What You Will Learn:
- How to use JavaScript Temporal.PlainDate
- How to work with dates without time
- How to add and subtract days
- How to compare dates safely
Temporal.PlainTime
A Temporal.PlainTime represents a time without a date or time zone.
It is useful for opening hours, alarms, and any time-only values.
Temporal.PlainDateTime
What You Will Learn:
- How to use JavaScript Temporal.PlainDateTime
- How to work with date and time without a time zone
- How to add and subtract dates
- How to compare dates safely
Temporal.ZonedDateTime
What You Will Learn:
- How to use JavaScript Temporal.ZonedDateTime
- How to handle time zones correctly
- How to add and subtract date
- How to avoid DST (Daylight Saving Time) bugs
- How to convert between time zones safely
Temporal.Now
The Temporal.Now object provides 5 methods to get the system's date and time.
One method for each date object:
- Temporal.Now.instant()
- Temporal.Now.plainDateISO()
- Temporal.Now.plainTimeISO()
- Temporal.Now.plainDateTimeISO()
- Temporal.Now.zonedDateTimeISO()
And one method to get system's time zone:
- Temporal.Now.timeZoneId()
Temporal Arithmetic
The Temporal API provides methods for easy and reliable date and time arithmetic.
Learn how to add and subtract dates safely using JavaScript Temporal.
Perform date arithmetic without DST bugs or mutation problems.
Temporal Formats
Temporal values can be converted to strings in different ways.
Temporal values can be formatted as:
- ISO strings (toString)
- Local strings (toLocaleString)
- Fully customized strings (Intl.DateTimeFormat)
Browser Support
Temporal is a major update to the JavaScript standard (TC39).
It is currently fully supported in Chrome, Edge, and Firefox, and is expected to reach full availability across browsers before the summer of 2026.
| Chrome 144 |
Edge 144 |
Firefox 139 |
Safari |
Opera |
| Jan 2026 | Jan 2026 | May 2025 | 🚫 | 🚫 |
Opera and Safari Support
Opera support will probably appear 1-3 browser cycles after Chromium, which often means a few months later.
The Safari implementation is in development and can be tested today in Safari Technology Preview by enabling the --use-temporal runtime flag.
Polyfill
Until Opera and Safari supports Temporal natively, you can use the official polyfill:
<script
src="https://cdn.jsdelivr.net/npm/@js-temporal/polyfill/dist/index.umd.js">
</script>
