CronCraft

cron 表達式工作室

建立能撐過時區、日光節約與週一早晨的 cron 排程

CronCraft 把難懂的 crontab 一行翻成白話,顯示任一 IANA 時區接下來 20 次的真實執行時刻,找出日光節約陷阱與同時執行的排程,並把同一份排程寫成 crontab、GitHub Actions、Kubernetes 與 systemd 格式。

  • 完全在瀏覽器執行
  • Unix、Quartz、EventBridge
  • IANA 時區與日光節約
  • 沒有帳號、沒有上傳

直接輸入表達式,或逐欄位建構。Unix 為 5 欄位,Quartz 與 EventBridge 為 6 欄位。

正在讀取表達式...

建立排程

選擇預設或直接編輯每個欄位,表達式與欄位會雙向同步。

Six things this studio does

Every one of them is testable in the panel above.

01

雙向白話說明

改表達式,欄位跟著變;改欄位,表達式跟著變。每次變更都有一句能對同事念出來的說明。

02

不是規則,是真實時刻

接下來 20 次以 IANA 資料庫計算,包含 30 分、45 分時差,以及每年消失或重複的兩小時。

03

上線前抓出同時執行

貼上 crontab,看哪些工作擠在同一分鐘,並用每週密度圖預先發現 00:00 一起啟動的狀況。

04

一份排程,四種平台

crontab、GitHub Actions、Kubernetes CronJob、systemd timer 語法各異。不必重打欄位就能匯出同一個意圖。

05

不離開這個分頁

本站沒有後端、沒有帳號、沒有儲存。唯一的外部請求是廣告腳本,它不會收到你的表達式。

06

可以驗證的建議

指南中的說法都能在上方工作室實測。改一個欄位,看看接下來幾次怎麼變。

The cron guide

A practical explanation of the syntax, the calendar rules and the failures that reach production.

cron 表達式真正在說什麼

傳統 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。
  • 星期日:0 與 7 都代表星期日。

看起來很像的四種格式

格式欄位順序額外功能
Unix cron分 時 日 月 星期@daily 等簡寫
Quartz / Spring秒 分 時 日 月 星期?、L、W、#
AWS EventBridge分 時 日 月 星期 年?、L、W、#、UTC
GitHub Actions分 時 日 月 星期固定 UTC,只有 5 欄位
Kubernetes CronJob分 時 日 月 星期1.27 起支援 timeZone

日與星期的 OR 規則

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 執行,只把顯示換成當地時間。

衝突與 00:00 的尖峰

十個每小時執行的工作沒問題,但全部在 0 分開始就會瞬間湧入。衝突檢查逐行解析 crontab,找出同一分鐘有兩個以上工作的區間,並畫出每週密度。每五分鐘的健康檢查撞上整點報告,或 02:15 的重新索引撞上同時段日誌輪替,都是典型例子。把分鐘錯開,或在工作內加入隨機等待。

不必重打就能匯出

crontab、GitHub Actions、Kubernetes CronJob、systemd timer 語法各不相同。本工具把相同欄位轉成各格式,像秒欄位這種無法對應的值會以註解說明。systemd 的 OnCalendar 不是 cron 語法,月底會轉成 ~01;第二個星期一這類沒有直接對應的規則不會被悄悄改掉,而是標示出來。

表達式去了哪裡

哪裡都沒去。解析、時區計算、日光節約檢查、衝突模擬、匯出都在此分頁的 JavaScript 執行。沒有後端、沒有帳號、沒有儲存,重新載入就回到範例。唯一的外部請求是繪製廣告的 AdSense 腳本,它不會收到表達式。

Frequently asked questions

Short answers to the questions that come up most often.

cron 表達式會被上傳嗎?

不會。解析、時區計算、日光節約檢查、衝突模擬與匯出都在此分頁的 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 時差區分兩個瞬間,日光節約卡片會計算落在重複時段的分鐘數。

為什麼每月 13 日的工作也在每個星期五執行?

Vixie 系 cron 在日與星期都受限時,只要其中一個符合就會執行。0 0 13 * 5 代表每月 13 日或所有星期五。請只留一個條件,並在指令內檢查日期。

如何在月底執行?

Quartz 與 EventBridge 的日欄位可用 L。Unix cron 沒有 L,常見做法是 28 到 31 日執行,隔天不是 1 日就結束。本工具會把 L 轉成 systemd 的 ~01。

GitHub Actions 支援時區嗎?

不支援。排程工作固定以 UTC 執行,只接受 5 欄位。首爾 09:00 要寫成 00:00 UTC,因為 UTC 沒有日光節約,當地時間會隨季節變化一小時。

可以每幾秒執行嗎?

只有含秒欄位的格式可以。Unix cron、GitHub Actions、Kubernetes CronJob 都是分鐘制。秒級工作建議用佇列或短間隔的 systemd timer。

如何找出同時執行的問題?

把 crontab 貼進衝突檢查,會顯示同一分鐘有兩個以上工作的區間與每週密度。把分鐘錯開或在工作內加入隨機等待,大多能解決。

可以匯出成 systemd 嗎?

可以。會轉成 OnCalendar 語法,支援分與時間隔、星期範圍、月底的 ~01。第二個星期一這類沒有直接對應的規則會以註解標示。

免費嗎?需要帳號嗎?

免費且不需要帳號。頁面由廣告支持。表達式、crontab、時區選擇都不會儲存或傳送,關閉分頁後不留副本。