Công cụ lập trình

Jiff 1.0 mang mô hình datetime mới đến hệ sinh thái Rust

Andrew Gallant phát hành Jiff 1.0, một thư viện datetime cho Rust lấy cảm hứng từ Temporal của JavaScript, ưu tiên an toàn về múi giờ và sự rõ ràng của API.

Một củ hành thủy tinh với các yếu tố đồng hồ lơ lửng trên một bánh răng kim loại, tượng trưng cho sự phức tạp nhiều lớp của datetime trong Rust.
Minh họa được tạo riêng cho bài viết này

Được dịch tự động từ bản gốc tiếng Anh.

Andrew Gallant đã công bố phiên bản 1.0 của Jiff, một thư viện datetime mới dành cho ngôn ngữ lập trình Rust. Thư viện này nhằm giải quyết những nhầm lẫn tồn tại lâu nay trong hệ sinh thái Rust liên quan đến việc xử lý ngày và giờ bằng cách cung cấp một thiết kế được lấy cảm hứng mạnh mẽ từ đề xuất Temporal của JavaScript. Phiên bản ổn định này đánh dấu cam kết về tính tương thích API dài hạn cho các dự án phụ thuộc vào nó.

Điều gì đã xảy ra

Trong nhiều năm qua, các nhà phát triển Rust đã tranh luận liệu nên sử dụng chrono hay time cho các thao tác datetime. Gallant lưu ý rằng cả hai thư viện đều đã đạt đến điểm cực đại cục bộ trong thiết kế của chúng, khiến việc cải thiện đáng kể trở nên khó khăn mà không gây ra các thay đổi phá vỡ (breaking changes). Ông thấy các API hiện có gây bối rối, đặc biệt khi xử lý chuyển đổi giờ địa phương, cơ sở dữ liệu múi giờ hệ thống và phép tính lịch. Thay vì cố gắng thuyết phục những người bảo trì hiện tại áp dụng các hướng đi hoàn toàn khác biệt, ông đã xây dựng Jiff để bao bọc độ phức tạp của lĩnh vực này và hướng dẫn người dùng sử dụng đúng cách.

Thư viện này đã nhận được sự chấp nhận rộng rãi trong các công cụ sản xuất trước khi đạt phiên bản 1.0. Các dự án như uv, Cargo, Starship, fd, Nushell, mise, Jujutsu và uutils/coreutils hiện đang sử dụng Jiff. Nó cũng là nền tảng cho một triển khai Temporal trong AWS LLRT. Với mức độ sử dụng phổ biến này, Gallant tuyên bố API đã ổn định, hứa hẹn tránh các phiên bản không tương thích semver trừ khi tìm thấy các lỗi nghiêm trọng. Sự ổn định này nhằm mục đích biến Jiff thành một phụ thuộc công cộng an toàn cho các thư viện khác trong hệ sinh thái.

Cách hoạt động

Jiff mô hình hóa việc xử lý datetime như một lớp vỏ hành tây, bắt đầu từ ngày và giờ dân sự đơn giản và xây dựng dần lên các datetime có vùng thời gian đầy đủ. Ở lớp cơ bản là civil::Date và civil::Time, đại diện cho ngày dương lịch và thời gian đồng hồ thuần túy không gắn với bất kỳ vị trí nào. Những loại này kết hợp thành civil::DateTime. Phía trên lớp này là Timestamp, đại diện cho một khoảnh khắc thời gian không mơ hồ dưới dạng nano giây kể từ Unix epoch. Lớp ngoài cùng là ZonedDateTime, kết hợp timestamp, civil datetime và TimeZone để biểu diễn một khoảnh khắc cụ thể trong một khu vực địa lý cụ thể.

Thư viện này lấy cảm hứng mạnh mẽ từ thư viện chuẩn Temporal của JavaScript, dịch các khái niệm API của nó sang các idiom của Rust. Ví dụ, kiểu Duration của Temporal được đặt tên là Span trong Jiff để tránh nhầm lẫn với std::time::Duration của thư viện chuẩn Rust. Tương tự, Instant của Temporal được gọi là Timestamp để phân biệt với std::time::Instant. Các kiểu Civil trong Temporal được gọi là "civil" trong Jiff. Mặc dù không phải là một triển khai một-một, Jiff cho phép các nhà phát triển quen thuộc với Temporal thấy API dễ hiểu. Nó tự động xử lý các bẫy phổ biến như chuyển đổi giờ tiết kiệm ánh sáng ban ngày (daylight saving time) bằng cách đặt các quy tắc múi giờ vào trung tâm của thiết kế.

Chi tiết chính

  • Jiff 1.0 cam kết ổn định API vô thời hạn để hỗ trợ vai trò là khối xây dựng của hệ sinh thái.
  • Thư viện này được đọc giống như "gif" với âm "g" nhẹ, tương tự như từ "gem."
  • Jiff sử dụng thuật ngữ Span cho khoảng thời gian và Timestamp cho khoảnh khắc để ngăn ngừa xung đột tên với các kiểu trong thư viện chuẩn Rust.
  • Múi giờ được xác định bằng các Định danh Cơ sở dữ liệu Múi giờ IANA, chẳng hạn như America/New_York hoặc Asia/Tokyo.
  • Thư viện hỗ trợ làm tròn ngày và phép tính lịch, cho phép các thao tác như làm tròn một span đến ngày gần nhất so với một ngày cụ thể.
  • Jiff chỉ hỗ trợ lịch Gregorian và giới hạn phạm vi datetime ở +/- 9999 năm.

Tại sao điều này quan trọng

Việc xử lý datetime nổi tiếng là dễ gây lỗi vì nó nằm ở giao điểm giữa thời gian hệ thống máy tính và thời gian dân sự của con người. Thời gian hệ thống dựa trên Unix time, trong khi thời gian con người liên quan đến các quy tắc phức tạp như giây nhuận, giờ tiết kiệm ánh sáng ban ngày và độ lệch địa lý. Nhiều thư viện hiện có truyền tải độ phức tạp này cho nhà phát triển, dẫn đến lỗi khi chuyển đổi giữa timestamp và đồng hồ địa phương. Jiff cố gắng bao bọc độ phức tạp này, khiến người dùng khó thực hiện các thao tác không hợp lệ hoặc hiểu sai dữ liệu múi giờ.

Đối với các trưởng nhóm kỹ thuật và kỹ sư xây dựng công cụ đa nền tảng, việc có một thư viện datetime ổn định, được mô hình hóa tốt sẽ giảm bớt gánh nặng bảo trì. Bằng cách áp dụng một thiết kế ngăn ngừa sự mơ hồ trong quá trình chuyển đổi múi giờ, Jiff giúp các đội ngũ tránh những lỗi tinh vi liên quan đến thay đổi đồng hồ. Việc áp dụng bởi các dự án công cụ Rust lớn gợi ý rằng nó có thể trở thành tiêu chuẩn de facto cho các ứng dụng Rust mới, giảm sự phân mảnh do lựa chọn trước đây giữa chrono và time.

Bạn có thể làm gì

  • Thêm jiff và anyhow vào dự án Cargo của bạn để kiểm tra các ví dụ API được cung cấp trong thông báo.
  • Xem xét ánh xạ giữa các khái niệm Temporal và kiểu Jiff nếu bạn có kinh nghiệm xử lý datetime trong JavaScript.
  • Thay thế logic datetime cũ trong các ứng dụng Rust của bạn bằng ZonedDateTime của Jiff để đảm bảo xử lý múi giờ chính xác.
  • Sử dụng kiểu Span cho phép tính lịch thay vì tính toán giây thủ công để cải thiện khả năng đọc mã.
  • Tham khảo CHANGELOG để hiểu các thay đổi phá vỡ giữa Jiff 0.2 và 1.0 nếu bạn là người dùng sớm.
  • Đánh giá Jiff cho các dự án mới nơi tính ổn định API dài hạn là yêu cầu đối với các phụ thuộc công cộng.
  • #rust
  • #datetime
  • #software engineering
  • #libraries
  • #temporal

Công cụ từ cửa hàng Bytechap

Đọc tiếp

Công cụ lập trình

Dùng Gemini và Z3 để tìm lỗi Go mà fuzzing bỏ sót

Một kỹ sư của Google đã kết hợp Gemini 4 Argon và bộ giải ràng buộc Z3 để phát hiện các panic khi chạy trong mã Go mà phương pháp fuzzing tiêu chuẩn không thấy được, qua đó phơi bày những điểm mù trong việc xử lý dung lượng slice.

Tất cả bài viết