Why is JavaScript Date timezone handling so confusing?

JavaScript’s Date object stores all timestamps as UTC milliseconds since epoch, but many of its methods (like getHours(), getDate()) return values in the user’s local timezone without making that explicit. This implicit local-timezone behavior, combined with inconsistent constructor parsing, leads to subtle bugs that are hard to reproduce across different machine timezones.

What is the best way to display a date in a specific timezone in JavaScript?

Use Intl.DateTimeFormat or toLocaleString() with the timeZone option set to an IANA timezone identifier. For example: new Date().toLocaleString("en-US", { timeZone: "America/New_York" }). This is the modern, standards-compliant approach without requiring a third-party library.

Should I use the Temporal API or stick with Date?

Temporal is the modern replacement for the Date object, offering explicit timezone handling, immutable types, and clear distinctions between calendar dates, wall-clock times, and UTC instants. Temporal is available in modern browsers and Node.js 22+. For new projects, using Temporal directly or via a polyfill is recommended over the legacy Date API.

JavaScript Date and Time Zone Handling Guide

May 2, 2026

Related Tools

Related Guides

Frequently Asked Questions

Why is JavaScript Date timezone handling so confusing?: JavaScript’s Date object stores all timestamps as UTC milliseconds since epoch, but many of its methods (like getHours(), getDate()) return values in the user’s local timezone without making that explicit. This implicit local-timezone behavior, combined with inconsistent constructor parsing, leads to subtle bugs that are hard to reproduce across different machine timezones.
What is the best way to display a date in a specific timezone in JavaScript?: Use Intl.DateTimeFormat or toLocaleString() with the timeZone option set to an IANA timezone identifier. For example: new Date().toLocaleString("en-US", { timeZone: "America/New_York" }). This is the modern, standards-compliant approach without requiring a third-party library.
Should I use the Temporal API or stick with Date?: Temporal is the modern replacement for the Date object, offering explicit timezone handling, immutable types, and clear distinctions between calendar dates, wall-clock times, and UTC instants. Temporal is available in modern browsers and Node.js 22+. For new projects, using Temporal directly or via a polyfill is recommended over the legacy Date API.