cron式の説明・次回実行日時

cron式を入れると、いつ実行されるかを日本語で説明し、次の実行日時を10件表示します。

分 時 日 月 曜日 の5項目(秒つきの6項目、Quartz の7項目、@daily などの別名も可)
よく使う例

cron式を入力してください

できること

  • cron式を日本語の文に「0 9 * * 1-5」を「毎週平日(月〜金曜日)の 9:00」のように言い換え、5つ(または6〜7つ)の項目それぞれの意味も表で示します。
  • 次の実行日時を10件日本時間と UTC を切り替えて表示し、もう一方の時刻も小さく併記します。「あと何時間」も分かるので、設定ミスにすぐ気づけます。
  • 日と曜日の OR ルールに対応「0 12 15 * 1」のように日と曜日を両方書くと、標準の cron では「15日、または月曜日」に動きます。勘違いしやすいこの決まりを正しく計算し、注意を出します。
  • Quartz の L・W・# もJava の Quartz 形式(秒から始まる6〜7項目、「?」)の末日 L、最寄りの平日 W、第n曜日 # を読み取ります。曜日の数字が標準 cron と1つずれる点も知らせます。

使い方

  1. cron式を入れるcrontab の1行から、コマンド部分を除いた日時の部分(例: 30 2 * * *)を貼り付けます。下の「よく使う例」を押して試すこともできます。
  2. 説明と項目の意味を確かめる日本語の説明と、分・時・日・月・曜日ごとの意味が表示されます。間違いがあれば、どの項目のどの値がおかしいかを示します。
  3. 次の実行日時を見るサーバーのタイムゾーンに合わせて「日本時間」か「UTC」を選びます。GitHub Actions など UTC で動くサービスでは、日本時間より9時間遅れて見える点に注意してください。

対応している書き方

書き方意味標準Quartz
*すべての値○○
1,15リスト(1と15)○○
9-17範囲(9〜17)○○
*/5・10-50/10・5/15ステップ(5ごと、10〜50の10ごと、5から15ごと)○○
JAN〜DEC・SUN〜SAT月と曜日の英語名(大文字小文字は問わない)○○
@daily など@yearly @annually @monthly @weekly @daily @midnight @hourly @reboot○—
?日か曜日の「指定なし」—○
L・L-3・LW末日・末日の3日前・最後の平日(日の項目)—○
15W15日に最も近い平日(月をまたがない)—○
6L・3#2最後の金曜日・第2火曜日(Quartz の数字は 1=日曜)—○

標準 cron の曜日は 0〜7(0 と 7 が日曜)、Quartz は 1〜7(1 が日曜)です。Quartz の7項目めの「年」は 1970〜2099 年に対応します。祝日の判定や、「@every 5m」のような Go 系ライブラリ独自の書き方には対応していません。

よくある質問

「毎月15日の月曜日だけ」にしたいのに、毎週月曜日にも動きます

標準の cron は、日と曜日の両方に値を書くと「どちらかに当てはまる日」に実行します(OR)。両方を満たす日だけにするには、cron では毎週月曜日(または毎月15日)に起動し、実行するスクリプトの中で日付を確かめる方法が一般的です。なお、片方が「*/2」のように「*」で始まる場合は、Vixie cron・cronie では AND として扱われます。このツールはその挙動に合わせて計算します。

GitHub Actions の schedule が9時間ずれて動きます

GitHub Actions の cron は UTC で解釈されます。日本時間の 9:00 に動かしたいなら、UTC の 0:00(0 0 * * *)と書きます。「UTC」に切り替えて次回の日時を見ると、ずれ方が確かめられます。なお、混雑時は数分〜数十分遅れて始まることがあります。

月末に実行したいときはどう書きますか?

Quartz 形式なら日の項目に L と書けます(例: 0 0 0 L * ?)。標準の cron には末日の指定がないため、28〜31日に毎日起動して「明日が1日なら処理する」とスクリプトで判定するのが定番です。

表示される次回の日時は、実際のサーバーと同じになりますか?

式の意味どおりに計算した日時です。サーバーのタイムゾーン設定(TZ や CRON_TZ)、夏時間のある地域での切り替え、サーバーの停止などは反映できません。本番の環境で動かす前に、ログでも確かめてください。

入力したcron式はどこかに送られますか?

送られません。解析も日時の計算も、お使いのブラウザの中だけで行います。このページは外部と通信しない設定です。保存するのは「形式」と「タイムゾーン」の選択だけで、cron式は保存しません。