ZonedDateTime Reference
The Temporal.ZonedDateTime Object
A Temporal.ZonedDateTime is a timezone and calendar-aware date and time object that represents a real time of a particular region on Earth.
It is optimized for cases that require a time zone, DST-safe arithmetic and interoperability with an RFC 5545 calendar.
Example
Example: December 7th, 1995 at 3:24:30 AM in US Pacific time (in Gregorian calendar).
const zonedDate = Temporal.ZonedDateTime.from({
timeZone: 'Europe/Oslo',
year: 2026,
month: 5,
day: 17,
hour: 14,
minute: 30,
second: 0,
});
Try it Yourself »
Temporal.ZonedDateTime Methods
Revised March 2026
| Constructing | Description |
|---|---|
| new | Creates a ZonedDateTime object |
| from() | Creates a ZonedDateTime object from an object or a string |
| Converting | |
| getTimeZone Transition() |
Returns a ZonedDateTime object representing the closest instant after or before this instant |
| toInstant() | Returns a Instant object representing this date-time |
| toPlainDate() | Returns a PlainDate object representing this date-time |
| toPlainDateTime() | Returns a PlainDateTime object representing this date-time |
| toPlainTime() | Returns a PlainTime object representing this date-time |
| startOfDay() | Returns a ZonedDateTime representing the first instant of this date |
| Updating | |
| with() | Returns a ZonedDateTime with specified fields modified |
| withCalendar() | Returns a ZonedDateTime with a different calendar system |
| withPlainTime() | Returns a ZonedDateTime the time part replaced by a new time |
| withTimeZone() | Returns a ZonedDateTime representing this date in a new time zone |
| Arithmetic | |
| add() | Returns a ZonedDateTime with a duration added |
| subtract() | Returns a ZonedDateTime with a duration subtracted |
| round() | Returns a ZonedDateTime rounded to a given unit |
| Comparing | |
| compare() | Returns -1, 0, or 1 from comparing two dates |
| equals() | Returns true if two ZonedDateTime objects are identical |
| since() | Returns the difference from another date |
| until() | Returns the difference until another date |
| Formatting | |
| toJSON() | Returns an ISO 8601 string for JSON serialization |
| toLocaleString() | Returns a language-sensitive representation of the date |
| toString() | Returns an ISO 8601 string representation |
| valueOf() | Throws a TypeError (prevents temporals from being converted to primitives) |
Temporal.ZonedDateTime Properties
| Property | Description |
|---|---|
| calendarId | Calendar system identifier ("iso8601") |
| day | The day as an integer (1-31) |
| dayOfWeek | The day of the week as an integer (1 = Monday) |
| dayOfYear | The ordinal day of the year |
| daysInMonth | The total number of days in that month |
| daysInWeek | The total number of days in that week |
| daysInYear | The total number of days in that year |
| epochMilliseconds | Number of milliseconds since Unix epoch |
| epochNanoseconds | Number of nanoseconds since Unix epoch |
| era | The era name of the calendar, if applicable |
| eraYear | The year within the era, if applicable |
| hour | The hour as an integer (0-23) |
| hoursInDay | Hours in this day in this time zone(0-25) |
| inLeapYear | A boolean indicating if the date falls in a leap year |
| microsecond | The microsecond as an integer (0-999) |
| millisecond | The millisecond as an integer (0-999) |
| minute | The minute as an integer (0-59) |
| month | The month as an integer (1-12) |
| monthCode | A calendar-specific string code for the month ("M01") |
| monthsInYear | The total number of months in that year |
| nanosecond | The nanosecond as an integer (0-999) |
| offset | Offset used to interpret this instant (+HH:mm:ss.sssssssss) |
| offsetNanoseconds | Offset used to interpret this instant in nanoseconds |
| second | The second as an integer (0-59) |
| timeZoneId | Time zone identifier used to interpret this instant |
| weekOfYear | The week number within the year |
| year | The year as an integer |
| yearOfWeek | The year that the week belongs to |
Learn More:
Browser Support
Temporal is a major update to the JavaScript standard (TC39).
It is currently supported in Chrome, Edge, Firefox, and Opera Safari has not shipped it yet.
| Chrome 144 |
Edge 144 |
Firefox 139 |
Safari |
Opera 128 |
| Jan 2026 | Jan 2026 | May 2025 | 🚫 | Feb 2026 |
The Safari implementation can be tested in Safari Technology Preview by enabling the --use-temporal runtime flag.
Polyfill
Until Safari supports Temporal natively, you can use the official polyfill:
<script
src="https://cdn.jsdelivr.net/npm/@js-temporal/polyfill@0.5.1/dist/index.umd.js">
</script>
