Day.js: thư viện thay thế Moment.js chỉ 2kB

Day.js là gì?

Day.js là một thư viện JavaScript dùng để parse, validate, thao tác và định dạng ngày giờ, đóng gói chỉ trong 2kB với API tương thích phần lớn với Moment.js. Mỗi thao tác trả về một instance Day.js mới thay vì thay đổi instance gốc, còn các tính năng mở rộng như định dạng nâng cao được nạp qua plugin bằng dayjs.extend().

Các tính năng nổi bật của Day.js

• ✓Bất biến (immutable) theo thiết kế: các method như .add() hay .startOf() luôn trả về một instance Day.js mới thay vì sửa instance gốc.
• ✓Gọi method nối tiếp (chainable), ví dụ dayjs().startOf('month').add(1, 'day').format('YYYY-MM-DD HH:mm:ss').
• ✓Core chỉ 2kB.
• ✓File locale nạp theo yêu cầu — import 'dayjs/locale/es' rồi gọi dayjs.locale('es') thay vì đóng gói sẵn mọi ngôn ngữ.
• ✓Có hệ thống plugin cho các tính năng thêm như advancedFormat, chỉ được thêm vào khi gọi dayjs.extend().
• ✓API đủ gần với Moment.js để các thao tác parse, format, get/set, manipulate, query gần như dùng lại được ngay.

Cài đặt Day.js trong dự án

Cài Day.js chỉ cần một lệnh: npm install dayjs --save — đây là cách cài duy nhất được README nêu ra, không có lệnh yarn hay pnpm tương ứng. Sau đó chỉ cần import dayjs from 'dayjs' rồi gọi trực tiếp; README dẫn sang day.js.org để xem hướng dẫn cài đặt đầy đủ và API reference thay vì liệt kê hết trong README. Không thấy nhắc tới bước build hay file config riêng nào.

Parse, format và thao tác ngày giờ

Cách dùng Day.js đi theo đúng 5 động từ mà docs của nó liệt kê: parse, display, get & set, manipulate, và query. dayjs('2018-08-08') parse một chuỗi thành instance. dayjs().format('{YYYY} MM-DDTHH:mm:ss SSS [Z] A') format ngược lại ra chuỗi với token tuỳ chỉnh. dayjs().set('month', 3).month() vừa get vừa set một unit trong cùng một lệnh gọi. dayjs().add(1, 'year') manipulate bằng cách trả về instance mới, lùi hoặc tiến một năm. dayjs().isBefore(dayjs()) query, so sánh instance này với instance khác. Nối các thao tác này lại chính là ví dụ trong README: dayjs().startOf('month').add(1, 'day').set('year', 2018).format('YYYY-MM-DD HH:mm:ss').

Các trường hợp sử dụng phổ biến của Day.js

• •Định dạng và hiển thị ngày giờ trong UI mà không phải kéo theo một dependency ngày giờ nặng nề.
• •Thay thế Moment.js trong dự án hiện có, chủ yếu để giảm kích thước bundle.
• •Xây pipeline xử lý ngày giờ cần nối tiếp parse, manipulate, query, kiểu dayjs().startOf('month').add(1,'day').
• •Ứng dụng cần nhiều locale — chỉ nạp đúng locale đang dùng qua dayjs.locale().
• •Dự án muốn thêm tính năng định dạng dần dần về sau mà không làm phình bundle gốc, nhờ hệ thống plugin.

Day.js so với Moment.js và date-fns

Ai nên dùng Day.js

Đội đã quen API của Moment.js và muốn giữ nguyên tư duy đó trong một package nhẹ hơn là nhóm hợp với Day.js nhất. Nó cũng hợp với dự án mới quan tâm tới kích thước bundle mà không cần đủ mọi tính năng của Moment.js ngay từ đầu — bạn thêm plugin dần theo nhu cầu thay vì gánh hết mặc định. Dự án cần nhiều locale cùng lúc nên kiểm tra xem cách nạp từng locale qua dayjs.locale() có hợp với pipeline build của mình hay không trước khi chốt.

Câu hỏi thường gặp về Day.js

Vấn đề mà Day.js giải quyết

Moment.js mutable — gọi .add() trên một instance là instance đó đổi luôn tại chỗ, dễ sinh bug khi instance ấy được share hoặc dùng lại ở nơi khác trong code. Vấn đề Day.js giải quyết khá hẹp và rõ: giữ nguyên tên method và tư duy của Moment.js để việc chuyển sang không phải học lại API, nhưng đổi mọi thao tác thành trả về instance mới và rút gọn cả thư viện xuống còn 2kB.

Repo liên quan