cron式の読み方 5フィールドの順序と記号、日と曜日の注意点

目次
5つのフィールドの順序はいつも同じ
cron式はスペースで区切られた5つのフィールドで構成され、順序は常に分-時-日-月-曜日です。この順序はどのcrontabでも、どのCIスケジューラでも同じルールなので、一度覚えてしまえばずっと使い回せます。
位置
意味
値の範囲
1番目
分
0~59
2番目
時
0~23
3番目
日(day-of-month)
1~31
4番目
月
1~12
5番目
曜日(day-of-week)
実装によって 0~6 または 0~7
曜日フィールドの数値の範囲は、実装によって少しずつ違います。0と7の両方を日曜として扱うことがよくありますが、この点はcronごとに差があるので、数字を暗記するより、ツールが表示する曜日名(月/火/水など)を基準に確認したほうが安全です。
アスタリスク、アスタリスク/N、数値の3つだけ分かれば全部読めます
各フィールドに入る記号は、大きく3種類に分けられます。
- アスタリスク(*)— そのフィールドで取りうるすべての値を意味します。「分」の位置にアスタリスクがあれば毎分、「曜日」の位置にあれば曜日に関係なく毎日という意味です。
- アスタリスク/N(*/N)— N単位で繰り返すステップです。分の位置に */15 と書けば、0、15、30、45分ごとに実行されます。
- 特定の数値 — その値になったときだけ実行されます。時の位置に 9 と書けば、ちょうど9時にだけ実行されます。
さらに、カンマで複数の値を並べる書き方もあります。曜日の位置に 1,3,5 を入れれば月・水・金だけ、月の位置に 3,6,9,12 を入れれば四半期の最初の月だけ実行されます。この4つの組み合わせさえ分かれば、「0 9 * * 1-5」のような式も「毎日9時0分、平日だけ」とすぐに読み解けます。
手で書くと、こんなことが起きます
「平日の午前9時に実行」というシンプルな要件でも、いざ手で書こうとすると順序が分からなくなります。分と時の順序を逆に書いてしまったり、曜日の数字が0始まりか1始まりかを毎回ドキュメントで探し直したり。式を1つ書いたあとに、実際にどの時刻に実行されるのかを検証する手立てもなかなかないので、crontabに登録して翌日ログを見てから、合っていたか間違っていたかに気づくというのもよくある話です。
分・時・日・月・曜日をドロップダウンで選ぶだけで、標準5フィールドのcron式とわかりやすい日本語の説明を同時に作れるツールです。

ドロップダウンでフィールドを1つずつ選ぶだけで、式と一緒に平易な文の説明がすぐ出てくるので、登録する前に意図した時刻になっているかを目で確認できます。よく使うパターンはプリセットとしても用意されているので、毎回ゼロから組み合わせる必要もありません。
日と曜日を一緒に書くと生まれる落とし穴
cronでもっともよく誤解されるのが、日(day-of-month)と曜日(day-of-week)を同時に指定したときの動作です。「毎月15日で、かつその日が月曜日のときだけ実行」を意図して、日の位置に 15、曜日の位置に 1 を同時に入れるケースがありますが、ほとんどのcron実装はこの2つをANDではなくORとして扱います。
つまり実際に実行されるのは、「毎月15日そのもの」か「その月のすべての月曜日」のどちらかに当てはまれば実行されます。15日が月曜でない月でも15日には必ず実行され、月曜日にも毎回実行されるわけです。この動作は2つのフィールドのどちらか一方でもアスタリスク(*)でなければ常に適用されるルールなので、日と曜日を同時に絞って「積集合」を作りたいときは、cronの文法だけでは表現できないと覚えておきましょう。
こうした条件を本当に設定したいなら、スケジューラ側の条件ではなく、実行されるスクリプトの中で今日の日付と曜日を自分で検査し、条件に合わなければ終了するという回避策が一般的です。
タイムゾーンが違うと、まったく違う時刻に実行されます
cron式そのものにタイムゾーンの情報はありません。式はただの数値の組み合わせでしかなく、その数値をどのタイムゾーンで解釈するかは、cronが動いているサーバーやスケジューラ、CIランナーの設定に完全に依存します。そのため「毎日午前9時」と作った式でも、実行する側が別のタイムゾーンに合わせてあれば、実際にはまったく違うローカル時刻に実行されます。
スケジューラごとにタイムゾーンの指定方法も違い、初期値もまちまちなので、正確な実行時刻が重要な作業であれば、式を登録する前にそのスケジューラのタイムゾーン設定を自分で確認するのが唯一安全な方法です。自分のローカルの時計と同じだと決めつけないほうがよいでしょう。
まとめ
- cron式は分-時-日-月-曜日の順に固定された5つのフィールドで、順序自体はどの実装でも変わりません。
- 各フィールドには、アスタリスク(*、すべての値)、アスタリスク/N(ステップ)、特定の数値、カンマ区切りのリスト(複数の値)のいずれかが入ります。
- 日と曜日を同時に指定するとANDではなくORとして解釈され、意図より頻繁に実行されることがあります。
- 実行時刻はcronが動くサーバー・スケジューラのタイムゾーンを基準に決まるので、登録前のタイムゾーン確認が必要です。
- 曜日の数値範囲は実装ごとに差があるので、数字より曜日名を基準に確認したほうが安全です。
分・時・日・月・曜日をドロップダウンで選ぶだけで、標準5フィールドのcron式とわかりやすい日本語の説明を同時に作れるツールです。
よくある質問
cron式で曜日の0は日曜ですか、月曜ですか
実装によって異なります。0を日曜として扱い、7も別途日曜を意味する場合がよくありますが、これはcronごとに少しずつ違う部分です。数字を覚えて使うより、使っているツールやスケジューラが表示する曜日名を基準に確認するのが安全です。
毎月15日で、月曜日だけに実行したいのですが、どうすればいいですか
日(day-of-month)と曜日(day-of-week)のフィールドを、標準のcron文法だけで同時に絞り込んで積集合の条件を作ることはできません。2つのフィールドを同時に指定するとORとして解釈され、15日なら必ず、月曜なら必ず実行されます。本当に積集合の条件が必要なら、実行されるスクリプトの中で今日の日付と曜日を自分で検査し、条件に合わなければ終了するように実装する方法が一般的です。
cron式を登録したのに、思った時刻に実行されません
まず確認したいのはタイムゾーンです。cron式自体にタイムゾーンの情報はなく、実行する側(サーバー、スケジューラ、CIランナー)に設定されたタイムゾーンを基準に解釈されるため、ローカルの時計と違うことがあります。次に、日と曜日のフィールドを同時に指定していないかを確認し、意図せずOR条件になって実行回数が増えていないか点検してみてください。
アスタリスク(*)とアスタリスク/N(ステップ)の違いは何ですか
アスタリスク(*)はそのフィールドで取りうるすべての値を意味し、分のフィールドなら毎分条件を満たすという意味になります。アスタリスク/Nは、その中からN単位で飛ばしながら繰り返す値だけを選ぶという意味で、分のフィールドに */15 と書けば0、15、30、45分だけ条件を満たします。つまりアスタリスク/Nは、アスタリスク(*)が作る全範囲の上に一定間隔の条件を重ねたものです。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む