Trình phân tích và tạo Cron

Một biểu thức cron chuẩn có năm trường cách nhau bởi dấu cách: phút (0–59), giờ (0–23), ngày trong tháng (1–31), tháng (1–12) và thứ trong tuần (0–6, 0 là Chủ nhật; đa số trình triển khai cũng chấp nhận 7). Mỗi trường dùng * cho mọi giá trị, dấu phẩy để liệt kê (1,15), gạch nối cho khoảng (1-5) và dấu gạch chéo cho bước nhảy (*/10 là mỗi 10 đơn vị). Ví dụ 0 9 * * 1-5 là 9:00 các ngày thứ Hai đến thứ Sáu, */5 * * * * là mỗi năm phút, 0 0 1 * * là nửa đêm ngày 1 hằng tháng. Nếu nhập sáu trường, trường đầu tiên được hiểu là giây, định dạng phổ biến trong các bộ lập lịch Node.js.

Công cụ dịch biểu thức sang ngôn ngữ dễ hiểu và liệt kê năm lần chạy thực tế tiếp theo để bạn kiểm tra lịch trước khi triển khai. Lỗi kinh điển là đảo phút và giờ: muốn chạy lúc 2:30 mỗi ngày phải viết 30 2 * * *, không phải 2 30 * * * (không hợp lệ vì giờ tối đa là 23). Một cái bẫy khác là bước nhảy tính lại trong từng đơn vị: */45 * * * * chạy ở phút 0 và phút 45 mỗi giờ, nên khoảng cách không phải lúc nào cũng là 45 phút.

Hãy cẩn thận khi giới hạn cùng lúc ngày trong tháng và thứ trong tuần. Với cron chuẩn (Vixie), nếu cả hai trường đều không phải *, công việc sẽ chạy khi một trong hai khớp, chứ không cần cả hai. Vì vậy 0 0 13 * 5 chạy vào ngày 13 hằng tháng và mọi thứ Sáu, không chỉ thứ Sáu ngày 13. Các nền tảng dùng cú pháp Quartz (Java và một số dịch vụ đám mây) có bảy trường và dùng ? cho "không chỉ định", khác với cú pháp Unix ở đây.

Múi giờ là nguyên nhân gây lỗi lập lịch nhiều nhất. Công cụ hiển thị lần chạy tiếp theo theo múi giờ của trình duyệt, nhưng máy chủ, GitHub Actions và nhiều bộ lập lịch đám mây mặc định dùng UTC. 9:00 giờ Việt Nam (UTC+7) là 2:00 UTC, nên cần viết 0 2 * * *. Luôn kiểm tra múi giờ của nền tảng đích trước khi đưa vào sử dụng.