cron式の説明・次回実行日時
cron式を入れると、いつ実行されるかを日本語で説明し、次の実行日時を10件表示します。
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つずれる点も知らせます。
使い方
- cron式を入れるcrontab の1行から、コマンド部分を除いた日時の部分(例: 30 2 * * *)を貼り付けます。下の「よく使う例」を押して試すこともできます。
- 説明と項目の意味を確かめる日本語の説明と、分・時・日・月・曜日ごとの意味が表示されます。間違いがあれば、どの項目のどの値がおかしいかを示します。
- 次の実行日時を見るサーバーのタイムゾーンに合わせて「日本時間」か「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日前・最後の平日(日の項目) | — | ○ |
15W | 15日に最も近い平日(月をまたがない) | — | ○ |
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式は保存しません。