CronCraft

cron 式スタジオ

タイムゾーン、夏時間、月曜の朝に耐える cron スケジュールを

CronCraft は読みにくい crontab の 1 行をやさしい言葉に変え、任意の 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 分のオフセット、年に 2 回消える時間と繰り返す時間も含みます。

03

リリース前に同時実行を見つける

crontab を貼り付けて同じ分に重なるジョブを確認し、週間密度マップで 00:00 に一斉に走る状況を事前に把握できます。

04

1 つのスケジュールを 4 つの基盤へ

crontab、GitHub Actions、Kubernetes CronJob、systemd timer は文法が違います。フィールドを打ち直さずに同じ意図を書き出せます。

05

タブの外へ出ない

このサイトにバックエンド、アカウント、保存領域はありません。外部リクエストは広告スクリプトだけで、式を受け取ることはありません。

06

検証できる助言

ガイドの主張は上のスタジオで試せます。フィールドを 1 つ変えて次の実行がどう変わるか見てください。

The cron guide

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

cron 式が本当に意味していること

伝統的な cron 式は左から分、時、日、月、曜日の 5 つのフィールドです。15 2 * * 1-5 は 1 つのルールではなく 5 つの独立したフィルターです。火曜の 02:15 は 5 つすべてが通り、土曜の 02:15 は曜日で止まり、02:16 は分で止まります。フィールド同士は相談しません。このモデルだけで多くの意外な動作が説明できます。

0 9 * * 1-5 は平日 09:00 に 1 回動きます。分を */15 にすれば 09:00、09:15、09:30、09:45、時を 9-17 に広げれば 17:45 まで 15 分ごとです。

範囲、リスト、間隔、名前

  • 範囲: 1-5 は 1 から 5 まで。5-1 のような逆順はほぼエラーです。
  • リスト: 1,15,30 はその 3 つだけ。
  • 間隔: */15 は最小値から 15 刻み、5/15 は 5、20、35、50 です。
  • 名前: 月は JAN から DEC、曜日は SUN から SAT が使えます。
  • 日曜: 0 と 7 はどちらも日曜です。

似ているが違う 4 つの形式

形式フィールド順追加機能
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 日の金曜だけにしたいときは条件を 1 つにしてコマンド内で日付を確認します。月末は Quartz と EventBridge の L が使えます。Unix cron には L がないため 28 日から 31 日に動かし、翌日が 1 日でなければ終了する方法が一般的です。0 0 31 * * は 2、4、6、9、11 月には動きません。

タイムゾーン: スケジュールはどこかで動く

cron 式にタイムゾーンはありません。実行する機械の壁時計を読みます。ソウルのサーバーの毎日 02:00 はソウル 02:00 で、ランナーを UTC に移せば式をそのままに 9 時間ずれます。GitHub Actions は UTC のみ、Kubernetes は timeZone がなければコントローラの時間帯、systemd はホストの時間帯を使います。

タイムゾーンボードは IANA データベースで次の 20 回を解決します。30 分や 45 分のオフセットも同じ経路で扱うため、固定オフセットの推測ではありません。

夏時間: 2 つの異なる失敗

春は存在しない時間が生まれ、秋は同じ時間が 2 度現れます。アメリカ東部では 3 月第 2 日曜に 02:00 が 03:00 へ飛び、30 2 * * * はその日 02:30 がありません。11 月第 1 日曜には 01:00 から 01:59 が 2 度現れ、30 1 * * * は 2 回動く可能性があります。重複を抑止する実装もあり、冪等にするのが安全です。インフラの仕事は UTC で動かし、表示だけ現地時間にすると影響を受けません。

衝突と 00:00 の集中

毎時動く 10 個のジョブは問題ありませんが、すべて 0 分に始まると瞬間的に集中します。衝突チェックは crontab を 1 行ずつ読み、同じ分に 2 つ以上動く区間と週間密度を表示します。5 分ごとの監視が毎時のレポートと重なる、02:15 の再インデックスが同じ時刻のログローテーションと重なる、といった例が典型です。分をずらすか、ジョブ内にランダムな待機を入れます。

打ち直さずに書き出す

crontab、GitHub Actions、Kubernetes CronJob、systemd timer は文法が違います。同じフィールドを各形式へ移し、秒フィールドのように移せない値はファイルのコメントで知らせます。systemd の OnCalendar は cron 構文ではなく、月末は ~01 に変換します。第 2 月曜のように直接対応しない規則は黙って変えずに印を付けます。

式はどこへ行くのか

どこにも行きません。解析、時間帯計算、夏時間チェック、衝突シミュレーション、書き出しはすべてこのタブの JavaScript で動きます。バックエンドもアカウントも保存領域もなく、再読み込みすると例に戻ります。外部リクエストは広告を描く AdSense スクリプトだけで、式は渡されません。

Frequently asked questions

Short answers to the questions that come up most often.

cron 式はアップロードされますか?

いいえ。解析、時間帯計算、夏時間チェック、衝突シミュレーション、書き出しはすべてこのタブの JavaScript で動きます。バックエンドもアカウントもありません。外部リクエストは広告スクリプトだけで、式や crontab の内容を受け取りません。

どの形式に対応していますか?

3 つのフィールド順に対応しています。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 に換算してください。

夏時間開始で消えた時間のジョブはどうなりますか?

その壁時計の時刻が存在しないため実行する瞬間がありません。実装によっては飛ばす、空白の直後に 1 回動かす、別の挙動をします。夏時間カードが該当する分を表示するので、ジョブを移すか冪等にできます。

秋の繰り返し時間はどうなりますか?

同じ壁時計が 2 度現れ、どちらも有効です。2 回動く実装も、2 回目を抑止する実装もあります。タイムゾーンボードは UTC オフセットで 2 つの瞬間を示し、夏時間カードは繰り返し区間に該当する分を数えます。

毎月 13 日のジョブが毎週金曜にも動くのはなぜですか?

Vixie 系 cron は日と曜日の両方が制限されていると、どちらかが一致すれば実行します。0 0 13 * 5 は毎月 13 日またはすべての金曜です。条件を 1 つにしてコマンド内で日付を確認してください。

月末に実行するには?

Quartz と EventBridge は日のフィールドに L を使えます。Unix cron にはないため、28 日から 31 日に動かし翌日が 1 日でなければ終了する方法が一般的です。このツールは L を systemd の ~01 に変換します。

GitHub Actions は時間帯に対応していますか?

いいえ。予約ワークフローは UTC で動き、5 フィールドのみです。ソウルの 09:00 は 00:00 UTC と書き、UTC に夏時間はないため現地時刻は季節で 1 時間変わります。

秒単位で実行できますか?

秒フィールドがある形式のみです。Unix cron、GitHub Actions、Kubernetes CronJob は分単位です。秒単位の処理はキューや短い間隔の systemd timer が安全です。

同じ分に集中するジョブはどう見つけますか?

衝突チェックに crontab を貼ると、同じ分に 2 つ以上動く区間と週間密度を表示します。分をずらすか、ジョブ内にランダムな待機を入れるとほとんど解消します。

systemd に書き出せますか?

はい。OnCalendar 構文へ変換し、分・時の間隔、曜日範囲、月末の ~01 に対応します。第 2 月曜など直接対応しない規則は生成ファイルのコメントで知らせます。

無料ですか?アカウントは必要ですか?

無料でアカウント不要です。ページは広告で支えられています。式、crontab、タイムゾーンの選択は保存も送信もされないため、タブを閉じれば写しは残りません。