Is moment-timezone still being developed?

No, moment-timezone is in maintenance mode along with Moment.js, meaning only critical security fixes are addressed. The maintainers recommend using modern alternatives like Luxon for new projects.

How do I convert a UTC date to local time with moment-timezone?

Use the .tz() method to set the time zone, then format it. For example, moment.utc('2023-01-01').tz('America/New_York').format() converts UTC to Eastern Time, handling offsets automatically.

moment-timezone vs Luxon: which is better for time zones?

Choose moment-timezone if you're stuck with Moment.js in a legacy codebase. For new work, Luxon is preferred as it's smaller, immutable, actively maintained, and created by the Moment team as a modern replacement.

How to handle daylight saving time correctly with moment-timezone?

Moment-timezone uses IANA data to automatically adjust for DST transitions. When parsing or converting dates, it applies the correct offset based on the date and zone, as shown in examples with PDT and PST.

What are the alternatives to moment-timezone for JavaScript?

Popular alternatives include Luxon, date-fns-tz, and the Intl.DateTimeFormat API. These offer similar time zone support with better performance, smaller bundles, and active development communities.

Does moment-timezone work with TypeScript?

Yes, via @types/moment-timezone, but as a legacy library, type definitions might lag behind updates. Newer libraries often have built-in or more robust TypeScript support.

Open-Awesome

moment-timezone

MITJavaScript0.6.1

Adds IANA time zone support to Moment.js for parsing, formatting, and manipulating dates across time zones.

Visit Website GitHub

3.9k stars839 forks0 contributors

What is moment-timezone?

Moment Timezone is an add-on library for Moment.js that provides IANA time zone support. It allows developers to parse, format, and manipulate dates across different time zones, handling daylight saving time and historical zone data. It extends the capabilities of Moment.js to include accurate time zone conversions and formatting.

Target Audience

Developers working with Moment.js who need to handle dates and times across multiple time zones, especially in legacy projects or applications requiring IANA time zone accuracy.

Value Proposition

It provides a seamless integration with Moment.js, offering a familiar API while adding robust time zone support with accurate historical data, making it a reliable choice for time zone-sensitive date manipulations in JavaScript.

Overview

Timezone support for moment.js

Use Cases

Best For

Displaying dates and times in a user's local time zone
Converting dates between different IANA time zones
Handling daylight saving time transitions in date calculations
Parsing and formatting dates with time zone abbreviations
Maintaining legacy projects that rely on Moment.js
Applications requiring historical time zone accuracy

Not Ideal For

New projects starting from scratch that can adopt modern date libraries like Luxon or date-fns
Applications where minimizing bundle size is a top priority for performance
Teams implementing immutable state patterns in frameworks like React or Vue
Environments requiring active library development with frequent updates and new features

Pros & Cons

Pros

IANA Time Zone Accuracy

Uses the official IANA time zone database for precise historical and future calculations, ensuring correct handling of daylight saving time and zone changes as highlighted in the key features.

Seamless Moment.js Integration

Extends the widely-used Moment.js library with a familiar chainable API, making it easy for developers in legacy projects to add time zone support without a steep learning curve.

Comprehensive Time Zone Features

Supports parsing, formatting, and manipulating dates across time zones with examples showing conversions between zones like America/Los_Angeles and Asia/Tokyo.

Legacy Project Compatibility

Ideal for maintaining existing applications that rely on Moment.js, providing a stable add-on for time zone needs without requiring a full library migration.

Cons

Legacy Maintenance Mode

The project is officially in maintenance mode with no active development, as stated in the README, meaning limited bug fixes and no new features, making it unsuitable for long-term projects.

Large Bundle Size

Adds significant overhead to the already bulky Moment.js library, resulting in larger bundle sizes compared to modern alternatives like Luxon or date-fns, which can impact web performance.

Mutable API Design

Inherits Moment.js's mutable API, which can lead to side effects and bugs in applications that prefer immutable data structures, especially in state-driven frameworks.

Frequently Asked Questions

Related Projects

Day.js

⏰ Day.js 2kB immutable date-time library alternative to Moment.js with the same modern API

Stars48,627

Forks2,427

Last commit7 days ago

Moment.js

Parse, validate, manipulate, and display dates in javascript.

Stars47,987

Forks7,007

Last commit1 year ago

date-fns

⏳ Modern JavaScript date utility library ⌛️

Stars36,562

Forks1,943

Last commit7 months ago

Luxon

⏱ A library for working with dates and times in JS

Stars16,382

Forks770

Last commit2 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub