Jiff 1.0 ra mắt: thư viện xử lý ngày giờ cho Rust

Công nghệ17 tháng 11, 2026·5 phút đọc

BurntSushi chính thức phát hành Jiff 1.0, thư viện ngày giờ cho Rust tập trung giải quyết các vấn đề múi giờ và giờ mùa hè (DST) ngay trong API. Jiff đã được dùng trong nhiều dự án lớn như uv, Cargo, Starship, Nushell và Jujutsu, và tác giả cam kết duy trì API ổn định lâu dài.

Jiff 1.0 ra mắt: thư viện xử lý ngày giờ cho Rust
Ảnh minh hoạ do AI tạo

Jiff, thư viện xử lý ngày giờ (datetime) cho Rust, vừa chính thức phát hành phiên bản 1.0. Điểm đáng chú ý là thư viện này đặt việc xử lý múi giờ lên trung tâm của API, thay vì để người dùng tự đối phó với những cạm bẫy quen thuộc như giờ mùa hè (DST - daylight saving time).

Trước khi đạt cột mốc 1.0, Jiff đã được dùng trong môi trường production ở nhiều dự án nổi tiếng của hệ sinh thái Rust: uv, Cargo, Starship, fd, Nushell, mise, Jujutsu, uutils/coreutils, và thậm chí là nền tảng cho một bản triển khai Temporal trong AWS LLRT.

Cam kết ổn định API

Tác giả cho biết trừ khi phát hiện lỗi nghiêm trọng nào đó trong API, kế hoạch là giữ Jiff ở phiên bản 1.0 vô thời hạn. Lý do là Jiff được thiết kế để trở thành một khối xây dựng của hệ sinh thái, xuất hiện trong API công khai của các thư viện khác, nên các bản phát hành không tương thích semver sẽ gây đau đớn lớn cho toàn bộ hệ sinh thái.

Tư duy "củ hành" về thời gian

Jiff xây dựng các kiểu dữ liệu theo mô hình nhiều lớp, hay còn gọi là "củ hành datetime". Từ trong ra ngoài:

  • civil::Date: một ngày theo lịch Gregory, không gắn với vị trí địa lý nào.
  • civil::Time: một giờ trên đồng hồ, chính xác tới nano giây, cũng không gắn với vị trí.
  • civil::DateTime: kết hợp ngày và giờ, vẫn không gắn với vị trí.
  • Timestamp: một thời điểm cụ thể, không mơ hồ, biểu diễn bằng số nano giây kể từ kỷ nguyên Unix (Unix epoch).
  • TimeZone: tập luật ánh xạ giữa Timestamp và civil::DateTime trong một khu vực địa lý.
  • ZonedDateTime: kết hợp cả ba yếu tố trên để biểu diễn một thời điểm cụ thể tại một địa điểm cụ thể.

Cách mô hình hóa này cho phép tạo ra một ZonedDateTime từ hai hướng khác nhau: từ giờ trên đồng hồ kèm múi giờ, hoặc từ một Timestamp kèm múi giờ. Cả hai đều cho kết quả tương đương.

Xử lý giờ mùa hè và múi giờ

Jiff dùng các mã định danh múi giờ IANA (IANA Time Zone Database), ví dụ America/New_York, Asia/Tokyo, Europe/Berlin. Mỗi ZonedDateTime đều có một độ lệch (offset) so với UTC.

Điểm mạnh nhất của thư viện nằm ở cách xử lý hai tình huống khó: fold (khi đồng hồ bị lùi lại, khiến một khoảng giờ lặp lại) và gap (khi đồng hồ được đẩy tới, khiến một khoảng giờ bị bỏ qua). Mặc định, Jiff dùng chiến lược "compatible": chọn lần xuất hiện đầu tiên trong fold và thời điểm muộn hơn trong gap. Người dùng có thể đổi sang các chiến lược khác như earlier(), later() hoặc unambiguous() (trả lỗi khi có mơ hồ) thông qua API ở mức thấp hơn.

Hai kiểu biểu diễn khoảng thời gian

Jiff cung cấp hai kiểu cho khái niệm khoảng thời gian (duration):

  • Span: kiểu lai mạnh mẽ, kết hợp cả đơn vị lịch (năm, tháng, tuần, ngày) lẫn đơn vị vật lý (giờ, phút, giây, mili giây, micro giây, nano giây), đồng thời giữ nguyên giá trị từng đơn vị.
  • SignedDuration: phiên bản có dấu của std::time::Duration, luôn là số nguyên 96-bit nano giây, chỉ biểu diễn được thời gian vật lý chứ không biểu diễn được đơn vị lịch.

Vì Span giữ nguyên từng đơn vị, một span "2 giờ" là giá trị khác với span "120 phút" dù chúng tương đương về thời lượng vật lý. Để so sánh theo thời lượng thực, dùng Span::compare.

Phân tích và định dạng

Mọi kiểu ngày giờ và khoảng thời gian của Jiff đều triển khai trait FromStr và Display của thư viện chuẩn. Jiff hỗ trợ các chuẩn RFC 3339 (thời điểm có độ lệch cố định), RFC 9557 (bổ sung thông tin múi giờ IANA), và ISO 8601 (bao gồm cả khoảng thời gian và ngày giờ dân sự).

Ngoài định dạng ISO 8601, Jiff còn có định dạng "friendly" riêng, dễ đọc hơn cho người dùng và không bị mất mát thông tin. Ví dụ ISO 8601 không phân biệt được 2000 mili giây với 2 giây sau khi chuyển đổi qua lại, còn định dạng friendly thì giữ nguyên 2000ms.

Thư viện cũng cung cấp strptime và strftime tương thích gần như hoàn toàn với POSIX, dùng cho các định dạng ngày giờ tùy biến.

Hỗ trợ đa ngôn ngữ qua ICU4X

Bản thân Jiff không xử lý locale. Người dùng có thể tích hợp qua dự án ICU4X và crate jiff-icu, cho phép định dạng ngày giờ theo từng ngôn ngữ và vùng miền cụ thể.

Góc nhìn

Với lập trình viên Rust, Jiff 1.0 là tín hiệu đáng tin cậy để đưa thư viện này vào các dự án mới mà không lo phải chạy theo phiên bản không tương thích. Cam kết ổn định API dài hạn đặc biệt quan trọng với các doanh nghiệp xây dựng hệ thống dùng lâu năm, nơi chi phí nâng cấp phụ thuộc là một gánh nặng thực sự.

Về mặt nghiệp vụ, việc xử lý múi giờ và giờ mùa hè là nguồn lỗi kinh điển trong các hệ thống đặt lịch, thanh toán và hạch toán thời gian. Việc Jiff mặc định chọn chiến lược "compatible" và cho phép kiểm soát chiến lược giải quyết mơ hồ có nghĩa là các đội phát triển có thể chọn hành vi phù hợp với quy tắc nghiệp vụ của mình, thay vì phụ thuộc vào hành vi ngầm định của thư viện.

Tuy nhiên, các đội dùng Rust trong hệ thống đo lường hiệu năng vẫn nên nhớ lời khuyên của tác giả: đo thời gian chạy chương trình bằng đồng hồ đơn điệu (monotonic clock) như std::time::Instant, không dùng đồng hồ hệ thống.

Nguồn: burntsushi.net (bài gốc ngày 16 tháng 11, 2026) · Quy trình biên tập

Chia sẻ:FacebookX