marnusw/date-fns-tz

🌐 Hỗ trợ múi giờ IANA cho date-fns mà không cần bundle dữ liệu

Thư viện bổ trợ cho date-fns v3, dùng Intl API của trình duyệt để xử lý múi giờ mà không cần nhúng dữ liệu múi giờ vào bundle.

date-fns-tz là một thư viện JavaScript bổ sung hỗ trợ múi giờ cho date-fns phiên bản 3.0.0. Thay vì dựa vào các thư viện như Moment hay Luxon tự quản lý lớp thời gian, date-fns-tz sử dụng Intl API có sẵn trong trình duyệt và Node.js, tránh việc phải đưa dữ liệu múi giờ lớn vào gói code. Điều này giúp ứng dụng nhẹ hơn và hiệu suất cao hơn khi làm việc với thời gian đa múi giờ.

✨ Điểm nổi bật

• Intl API: Sử dụng API natively hỗ trợ trên trình duyệt hiện đại và Node.js, không cần polyfill nếu môi trường đủ.
• Hỗ trợ offset: Các múi giờ có thể được chỉ định dưới dạng offset như '-0200' hoặc '+04:00' khi không dùng polyfill.
• ESM & CommonJS: Hỗ trợ cả hai chuẩn module, tự động chọn entry point đúng qua trường exports trong package.json.
• formatInTimeZone: Định dạng thời gian theo múi giờ bất kỳ, bỏ qua múi giờ hệ thống.
• fromZonedTime: Chuyển đổi thời gian từ một múi giờ sang UTC dưới dạng Date.
• toZonedTime: Lấy thời gian đại diện cho giờ địa phương trong một múi giờ cụ thể từ một Date UTC.
• getTimezoneOffset: Lấy offset mili giây giữa múi giờ và UTC.
• format & toDate: Mở rộng date-fns/format với hỗ trợ token múi giờ z..zzzz và phân tích chuỗi thời gian theo múi giờ.

💡 Vì sao đáng chú ý

Khác với các thư viện như Moment hay Luxon tự quản lý lớp thời gian riêng, date-fns-tz giữ nguyên Date của JavaScript và chỉ thêm các hàm tiện ích để xử lý múi giờ. Nhờ đó, ứng dụng không cần thay đổi cách làm việc với thời gian mà vẫn có thể dễ dàng hiển thị giờ đúng ở bất kỳ múi giờ nào — ví dụ như hiển thị giờ sự kiện ở Los Angeles (8PM PST) cho người dùng ở bất kỳ nơ đâu. Phù hợp cho hệ thống quản lý sự kiện, dashboard đa múi giờ, hoặc bất kỳ ứng dụng nào cần làm việc với thời gian toàn cầu.

#JavaScript #date-fns #timezone #IANA #IntlAPI #TiniX