Cron 式パーサー

各フィールドが展開される内容

フィールドは1つの値ではなく、値の集合です。その集合がどれくらい大きいかが分かれば、たいていの疑問はそれだけで解決します。

フィールド内で使える演算子は次のとおりです。* はすべての値、1,5,10 はリスト、1-5 は範囲、*/15 は範囲の先頭から数えるステップ、0-45/15 は範囲内のステップです。

名前と短縮形も使えます

月と曜日は名前でも指定でき、一致する数値へ展開されます。たとえば 30 3 * JAN,JUL 1 なら、月は 1, 7、曜日は 1 と表示されます。名前付きの短縮形は、ほかの処理より先に5フィールド形式へ展開されます。

@reboot も認識されますが、展開できるスケジュールはありません。マシンの起動時に1回だけ実行されるため、プレビューする実行日時が存在しないからです。

目を通しておきたい警告

• 日と曜日の両方を指定した場合。 0 0 1 * MON は「1日、ただし月曜日のときだけ」という意味ではありません。標準の cron は、2つの日付フィールドが両方とも指定されているとき、これを OR として扱います。つまりこの行は、毎月1日と毎週月曜日のどちらにも実行されます。パーサーはこの警告を表示し、実行日時のプレビューも OR のルールに従います。
• 存在しない日付を指定した場合。 0 0 30 2 * は2月30日を指しています。構文としては正しく、cron も受け付けますが、実行されることは一度もありません。パーサーは、説明のない空のリストを見せる代わりに、その事実をはっきり伝えます。
• Quartz の演算子。 L（最終）、W（最も近い平日）、#（その月のN番目の該当曜日）、? は Quartz の拡張であり、標準の crontab にはありません。5フィールドの行に含まれていても認識はされますが、警告が表示され、そのフィールドには値の一覧ではなく Quartz の演算子である旨が示されます。標準の cron ではその行自体が実行されないため、実行日時は計算しません。

そのまま拒否されるもの

• フィールド数が違う式。 秒を含む6フィールドの Quartz の行や、年を含む7フィールドの行は、フィールド数の時点で拒否されます。
• 範囲外の値。 たとえば分の75や月の13です。
• 逆向きの範囲。 5-1 のような指定です。
• 0のステップ。 */0 のような指定です。

エラーには原因となったフィールドと値が必ず示されるので、行全体を書き直さずに1か所だけ直せます。

タイムゾーン

次回以降の実行日時は、お使いのブラウザで、端末に設定されたタイムゾーンをもとに計算されます。一方 crontab は、それが動いているマシンのタイムゾーンで実行されます。サーバーが UTC で動いていて手元の端末が日本時間（JST、UTC+9）なら、0 0 * * * が実際に動くのは日本時間の9時です。見比べる前に、その差を時刻に足し引きしてください。