Cron 產生與解析

Cron 解析器最關鍵的作用，不是讓表達式「看起來更高級」，而是在任務真正上線之前，把這串緊湊字元翻譯成人能檢查的執行規則。只要調度頻率、執行日期或工作時段寫錯，自動任務就可能在生產環境裡造成大麻煩。

目前頁面的範圍：標準五段 Cron

目前這個頁面實際支援的是五段 Cron 表達式：分、時、日、月、週。也就是說，它適合檢查標準 crontab 風格的排程規則；如果你的執行環境使用 Quartz 那樣的六段或七段語法，這裡更適合作為理解思路的輔助頁，而不是原樣照抄的驗證器。

• 欄位順序本身比你「眼熟不眼熟」更重要。
• 萬用字元、範圍、清單和步長的組合，往往是「看著像對的，實際跑起來卻不是你想的那樣」的來源。

如何使用這個工具

1. 輸入现有 Cron 表达式，或按欄位產生表达式，并先確認目標调度器方言。
2. 结合工作区中的时区假设，一起檢查可读描述和后续运行时间列表。
3. 只有当预览结果與生产任务要求的日期、时段和频率完全一致后，才继续複用表达式。

Cron 產生與解析 範例

這個 Cron 產生與解析 示例使用有代表性的带调度欄位和时区假设的 Quartz Cron 或标准 Crontab 表达式，展示產生后的可读的调度說明和按順序排列的未来执行时间，便于你先確認欄位数量、是否支持秒、星期規則、L/W/# 语法、时区、夏令时切换和调度器方言，再把同样設定用于真实輸入。

範例輸入

0 9 * * 1-5

預期輸出

Runs at 09:00 every weekday; upcoming run times are listed in order.

經典工作日排程範例

0 9 * * 1-5

含義：每個工作日 09:00 執行。

常見使用場景

Cron 產生與解析 最適合用在带调度欄位和时区假设的 Quartz Cron 或标准 Crontab 表达式需要快速变成可读的调度說明和按順序排列的未来执行时间的場景，尤其是任务排期、工作流自动化、报表发送、维护窗口和云调度器 QA。

• 用于產生或解析 Cron 表达式并预览后续运行时间，服务于任务排期、工作流自动化、报表发送、维护窗口和云调度器 QA。
• 處理重要輸入前，可先用示例流程確認欄位数量、是否支持秒、星期規則、L/W/# 语法、时区、夏令时切换和调度器方言。
• 当结果符合目標流程后，再複製或下载可读的调度說明和按順序排列的未来执行时间。

Cron 規則為什么上线后还会失败

Cron 真正容易出事故的时候，是表达式、时区和运行时假设從未被一起核对过。开发者以為写的是“每天九点”，平台却按 UTC 执行；运营以為写的是“工作日”，调度器却把星期定义解释成了另一套規則。解析页的价值，就在于把這些平时看不见的调度假设翻译成一串具体日期和时间，让你在上线前先看到错位。

• 只要任务跨地区或长期循环，就應先把时区和夏令时行為核对清楚。
• 在月底、跨周和夏令时切换附近，未来运行样本尤其值得重点檢查。
• 只有当预览结果和真实业务预期完全一致时，這条表达式才算真正可部署。

最容易把任務排錯的幾個點

Cron 事故高發點通常不是語法完全不會寫，而是欄位位置看錯、日期和星期混淆，或者預設以為伺服器時區和自己電腦時區一致。這幾類問題在自動任務上線後往往最難察覺。

• 一定要確認真實排程器使用的時區是什麼。
• 看後續執行時間預覽，通常比只靠腦內默讀表達式更可靠。

五段 Cron 欄位速覽

使用注意

• 複用可读的调度說明和按順序排列的未来执行时间前，先檢查欄位数量、是否支持秒、星期規則、L/W/# 语法、时区、夏令时切换和调度器方言。
• 最終必须在实际运行它的调度器里验证表达式，因為 Cron 方言和預設时区并不一致。
• 当结果会影响生产工作或客户可见内容时，應保留原始带调度欄位和时区假设的 Quartz Cron 或标准 Crontab 表达式以便回退和核对。

Cron 產生與解析 參考說明

Cron 產生與解析 的文案應說明 Cron 欄位、表達式範例、執行時間預覽和時區假設。

• 常見 Cron 表達式包含分鐘、小時、日期、月份和星期欄位。
• 啟用自動任務前，應仔細檢查步長、範圍、清單和萬用字元。
• 務必確認執行環境使用本地時間、UTC 還是指定時區。

參考資料

• man7: crontab(5)
• Quartz Scheduler CronTrigger Tutorial