WebGroundwebground.app
資訊與指南 · 開發參考

Cron 表示式指南與排程解析器

透過常見範例了解 cron 排程語法,並貼上任何五欄位表示式來檢查它,查看接下來的執行時間。

檢查 cron 表示式

以空格分隔的五個欄位:分鐘、小時、日期、月份、星期。

有效的 cron 表示式

逐欄位解析

  • 分鐘

    允許值:0 到 59

    值
    */15
    符合的值
    • 0
    • 15
    • 30
    • 45
  • 小時

    允許值:0 到 23

    值
    9-17
    符合的值
    • 9 到 17
  • 日期

    允許值:1 到 31

    值
    *
    符合的值
    每月的每一天
  • 月份

    允許值:1 到 12

    值
    *
    符合的值
    每個月
  • 星期

    允許值:0 到 7

    值
    MON-FRI
    符合的值
    • 星期一 到 星期五

接下來的執行時間

常用排程

  • * * * * *
    執行時間
    每分鐘
    捷徑
  • */5 * * * *
    執行時間
    每 5 分鐘
    捷徑
  • */30 * * * *
    執行時間
    每 30 分鐘
    捷徑
  • 0 * * * *
    執行時間
    每小時整點
    捷徑
    @hourly
  • 0 */6 * * *
    執行時間
    從午夜開始,每 6 小時一次
    捷徑
  • 0 0 * * *
    執行時間
    每天午夜
    捷徑
    @daily
  • 30 8 * * *
    執行時間
    每天上午 8:30
    捷徑
  • 0 9 * * 1-5
    執行時間
    星期一到星期五上午 9:00
    捷徑
  • 0 0 * * 0
    執行時間
    每個星期日午夜
    捷徑
    @weekly
  • 0 0 1 * *
    執行時間
    每月 1 日午夜
    捷徑
    @monthly
  • 0 0 1 */3 *
    執行時間
    1 月、4 月、7 月與 10 月的 1 日午夜
    捷徑
  • 0 0 1 1 *
    執行時間
    每年 1 月 1 日午夜
    捷徑
    @yearly

特殊字元

  • *
    含義
    該欄位的所有值。
    範例
    * * * * *
  • ,
    含義
    列出多個個別的值。
    範例
    0 9,18 * * *
  • -
    含義
    值的範圍,包含頭尾兩端。
    範例
    0 9-17 * * *
  • /
    含義
    間隔:從範圍的起點算起,每 n 個值取一個。
    範例
    */10 * * * *

Cron 表示式的組成

Cron 表示式由五個以空格分隔的欄位組成:分鐘、小時、日期、月份與星期。每個欄位指定工作可以在什麼時候執行,而工作會在所有欄位都符合的每一分鐘執行。

欄位可以是單一數字、代表所有值的星號、以逗號分隔的清單、以連字號表示的範圍,或以斜線表示的間隔。月份與星期也可以寫成三個字母的英文名稱,例如 JAN 或 MON。

常見的出錯原因

看起來正確的排程,仍然可能在意想不到的時間執行。

  • Cron 使用伺服器的時區,可能與您的時區不同。上方的執行時間採用的是您裝置的時區。
  • 當日期與星期都有設定時,只要其中一個符合,工作就會執行。
  • 在星期欄位中,0 與 7 都代表星期日。
  • */7 這類間隔會在每個新的小時、日或月重新起算,因此間距不一定平均。

常見問題 (FAQ)

為什麼我的六欄位表示式不被接受?+

Linux 與 macOS 上的標準 cron 使用五個欄位。六個或七個欄位的表示式來自 Quartz、Spring 等類似的排程器,它們多了秒欄位,有時還有年份,並使用 ? 與 L 等額外符號。

@daily 這類捷徑是什麼意思?+

它們是常用排程的簡稱。@hourly、@daily、@weekly、@monthly 與 @yearly 分別在每小時、每天、每週、每月或每年開始時執行。@reboot 只在系統啟動時執行一次,因此沒有可顯示的執行時間。

我輸入的表示式會被傳送到任何地方嗎?+

不會。表示式的檢查與執行時間的計算都在您的瀏覽器中完成。

探索更多 WebGround 工具

查看全部