雙向白話說明
改表達式,欄位跟著變;改欄位,表達式跟著變。每次變更都有一句能對同事念出來的說明。
cron 表達式工作室
CronCraft 把難懂的 crontab 一行翻成白話,顯示任一 IANA 時區接下來 20 次的真實執行時刻,找出日光節約陷阱與同時執行的排程,並把同一份排程寫成 crontab、GitHub Actions、Kubernetes 與 systemd 格式。
直接輸入表達式,或逐欄位建構。Unix 為 5 欄位,Quartz 與 EventBridge 為 6 欄位。
選擇預設或直接編輯每個欄位,表達式與欄位會雙向同步。
同一個表達式在兩個時區中解讀,並顯示排程器真正使用的時刻。
| # | 當地時間 | 星期 | 比較時區 | 時差 | 剩餘時間 |
|---|
時間以主要時區顯示。伺服器 cron 使用伺服器當地時間,部署前請固定 CRON_TZ 或先行換算。
貼上 crontab 行,查看兩個以上工作重疊的分鐘與每週密度。
貼上 crontab 行,查看兩個以上工作重疊的分鐘與每週密度。
把相同欄位寫成各平台要求的格式,可直接貼上。
Every one of them is testable in the panel above.
改表達式,欄位跟著變;改欄位,表達式跟著變。每次變更都有一句能對同事念出來的說明。
接下來 20 次以 IANA 資料庫計算,包含 30 分、45 分時差,以及每年消失或重複的兩小時。
貼上 crontab,看哪些工作擠在同一分鐘,並用每週密度圖預先發現 00:00 一起啟動的狀況。
crontab、GitHub Actions、Kubernetes CronJob、systemd timer 語法各異。不必重打欄位就能匯出同一個意圖。
本站沒有後端、沒有帳號、沒有儲存。唯一的外部請求是廣告腳本,它不會收到你的表達式。
指南中的說法都能在上方工作室實測。改一個欄位,看看接下來幾次怎麼變。
A practical explanation of the syntax, the calendar rules and the failures that reach production.
傳統 cron 表達式是從左到右的五個欄位:分、時、日、月、星期。15 2 * * 1-5 不是一條規則,而是五個獨立濾網。星期二 02:15 五個全部通過,星期六 02:15 被星期欄位擋下,02:16 被分欄位擋下。欄位之間不互相溝通,理解這一點就能解釋大多數意外行為。
0 9 * * 1-5 在平日 09:00 執行一次。把分改成 */15 會在 09:00、09:15、09:30、09:45 執行,把時擴大到 9-17 就會到 17:45 每 15 分鐘一次。
1-5 是一到五,5-1 這種反向寫法幾乎都是錯誤。1,15,30 只代表這三個值。*/15 從最小值每 15 個,5/15 是 5、20、35、50。JAN 到 DEC,星期可用 SUN 到 SAT。| 格式 | 欄位順序 | 額外功能 |
|---|---|---|
| Unix cron | 分 時 日 月 星期 | @daily 等簡寫 |
| Quartz / Spring | 秒 分 時 日 月 星期 | ?、L、W、# |
| AWS EventBridge | 分 時 日 月 星期 年 | ?、L、W、#、UTC |
| GitHub Actions | 分 時 日 月 星期 | 固定 UTC,只有 5 欄位 |
| Kubernetes CronJob | 分 時 日 月 星期 | 1.27 起支援 timeZone |
Vixie 系 cron 在日與星期都受限時,只要其中一個符合就會執行。因此 0 0 13 * 5 是每月 13 日或每個星期五。只要 13 日的星期五時,請只留一個條件,並在指令內檢查日期。月底在 Quartz 與 EventBridge 可用 L;Unix cron 沒有 L,常見做法是 28 到 31 日執行,隔天不是 1 日就結束。0 0 31 * * 在 2、4、6、9、11 月不會執行。
cron 表達式沒有時區,它讀取執行機器的牆上時鐘。首爾伺服器的每天 02:00 就是首爾 02:00,把執行器搬到 UTC 就會在不動表達式的情況下偏移九小時。GitHub Actions 只用 UTC,Kubernetes 未設定 timeZone 時使用控制器時區,systemd 使用主機時區。
時區面板以 IANA 資料庫計算接下來 20 次,30 分與 45 分時差也走同一條路徑,不是固定時差的估計。
春天會出現不存在的時間,秋天會出現兩次相同的時間。美國東部在 3 月第二個星期日把 02:00 跳到 03:00,30 2 * * * 當天沒有 02:30;11 月第一個星期日 01:00 到 01:59 出現兩次,30 1 * * * 可能執行兩次。有些實作會抑制重複,有些不會,讓工作具備冪等性最安全。基礎設施工作改用 UTC 執行,只把顯示換成當地時間。
十個每小時執行的工作沒問題,但全部在 0 分開始就會瞬間湧入。衝突檢查逐行解析 crontab,找出同一分鐘有兩個以上工作的區間,並畫出每週密度。每五分鐘的健康檢查撞上整點報告,或 02:15 的重新索引撞上同時段日誌輪替,都是典型例子。把分鐘錯開,或在工作內加入隨機等待。
crontab、GitHub Actions、Kubernetes CronJob、systemd timer 語法各不相同。本工具把相同欄位轉成各格式,像秒欄位這種無法對應的值會以註解說明。systemd 的 OnCalendar 不是 cron 語法,月底會轉成 ~01;第二個星期一這類沒有直接對應的規則不會被悄悄改掉,而是標示出來。
哪裡都沒去。解析、時區計算、日光節約檢查、衝突模擬、匯出都在此分頁的 JavaScript 執行。沒有後端、沒有帳號、沒有儲存,重新載入就回到範例。唯一的外部請求是繪製廣告的 AdSense 腳本,它不會收到表達式。
Short answers to the questions that come up most often.
不會。解析、時區計算、日光節約檢查、衝突模擬與匯出都在此分頁的 JavaScript 執行。本站沒有後端也沒有帳號。唯一的外部請求是廣告腳本,它不會收到表達式或 crontab 內容。
支援三種欄位順序。Unix cron 為 5 欄位,Quartz 與 Spring 為秒在前的 6 欄位,AWS EventBridge 為年在最後的 6 欄位。GitHub Actions 與 Kubernetes 使用 5 欄位,時區規則依平台而異。
cron 表達式沒有時區,它讀取執行伺服器的牆上時鐘。UTC 伺服器上的 02:00 工作會在 02:00 UTC,也就是首爾 11:00 執行。請修正執行器時區、設定 CRON_TZ,或把表達式換算成 UTC。
那個牆上時刻不存在,因此沒有可執行的瞬間。依實作可能跳過、在缺口後執行一次,或另有行為。日光節約卡片會列出落在缺口內的分鐘,讓你先決定是否移動工作或讓它具備冪等性。
同一個牆上時刻出現兩次,兩個瞬間都有效。排程器可能執行兩次,也可能抑制第二次。時區面板以 UTC 時差區分兩個瞬間,日光節約卡片會計算落在重複時段的分鐘數。
Vixie 系 cron 在日與星期都受限時,只要其中一個符合就會執行。0 0 13 * 5 代表每月 13 日或所有星期五。請只留一個條件,並在指令內檢查日期。
Quartz 與 EventBridge 的日欄位可用 L。Unix cron 沒有 L,常見做法是 28 到 31 日執行,隔天不是 1 日就結束。本工具會把 L 轉成 systemd 的 ~01。
不支援。排程工作固定以 UTC 執行,只接受 5 欄位。首爾 09:00 要寫成 00:00 UTC,因為 UTC 沒有日光節約,當地時間會隨季節變化一小時。
只有含秒欄位的格式可以。Unix cron、GitHub Actions、Kubernetes CronJob 都是分鐘制。秒級工作建議用佇列或短間隔的 systemd timer。
把 crontab 貼進衝突檢查,會顯示同一分鐘有兩個以上工作的區間與每週密度。把分鐘錯開或在工作內加入隨機等待,大多能解決。
可以。會轉成 OnCalendar 語法,支援分與時間隔、星期範圍、月底的 ~01。第二個星期一這類沒有直接對應的規則會以註解標示。
免費且不需要帳號。頁面由廣告支持。表達式、crontab、時區選擇都不會儲存或傳送,關閉分頁後不留副本。