cron式の読み方:5フィールドで実行日時を判断

cron式がわからなくなる実際の場面
サーバーのcrontabファイルやCI/CDのスケジュール設定には、説明もないまま '0 3 1,15 * 3' のような5つのマスに入った数字と記号の羅列だけが残っていることがよくあります。式を最初に作った人がすでにいない、あるいは他のチームからそのまま引き継いだ設定であれば、この1行が正確にいつ実行されるのかを聞ける相手がいません。
とくに問題になるのが、日(day-of-month)フィールドと曜日(day-of-week)フィールドが同時に値を持っている場合です。'1,15' は毎月1日と15日を、'3' は水曜日を指します。
この2つが並んでいるときに、「1日であり、かつ水曜日である日」に絞って読むのか、「1日または水曜日である日」に広げて読むのかで、1か月に実行される回数は大きく変わります。フィールドの規則を正確に知らなければ、表記を見ただけではどちらなのか判断できません。
ツールを使わずに自分で読み解く方法
cron式は、ツールがなくても順番に手で解きほぐせます。
ステップ1 — 5つのマスを順序と範囲に従って分けます。 空白で区切られたフィールドは必ず「分 時 日 月 曜日」の順序で並び、それぞれ決まった値の範囲を持ちます。
フィールド
順序
値の範囲
分
1番目
0~59
時
2番目
0~23
日(day-of-month)
3番目
1~31
月
4番目
1-12(JAN-DEC)
曜日(day-of-week)
5番目
0-7(SUN-SAT、0と7はどちらも日曜日)
フィールドがちょうど5つでない場合(例: '@daily' のようなマクロ、またはフィールド数が異なる入力)は、この標準の5フィールド表記ではありません。
ステップ2 — フィールドごとにコンマで分割し、各部分を解釈します。 1つのフィールドの中にコンマ(,)があれば、そのフィールドがマッチする値は、各部分が表す値の和集合になります。1つの部分は、次の4つの表記のいずれかです。
- '*' — そのフィールドの全範囲すべて
- 'a-b' — aからbまでの範囲(両端を含む)
- 単一の数字 'a' — その値ひとつ
- 'a/n' または '*/n' — 開始値からnきざみで飛ぶ値。'*/n' はそのフィールドの最小値から、'a/n' はaからそのフィールドの最大値まで飛ぶ値です。
ステップ3 — 月・曜日の英語の略号を数字に置き換えます。 月はJAN=1からDEC=12まで、曜日はSUN=0からSAT=6までに置換されます。曜日フィールドは数値0~7の範囲を許容し、0と7のどちらも日曜日を指します。日曜日を0と書いても7と書いても同じ日です。
ステップ4 — 日と曜日が同時に指定されているかを確認します。 日(day-of-month)と曜日(day-of-week)のフィールドがどちらも '*' でない場合、2つのフィールドはAND(積集合)ではなくOR(和集合)で判定されます。
その日が指定した日のいずれか、または指定した曜日のいずれかであれば実行されます。逆にどちらか一方でも '*' であれば、そのフィールドは条件から外れ、残りのフィールドだけで判定されます。
たとえば '30 9 * * 1-5' を順番に解くと次のようになります。
- 分: 30 → 30分
- 時: 9 → 9時
- 日: * → すべての日付
- 月: * → すべての月
- 曜日: 1-5 → 月曜日から金曜日まで
日と月が '*' で曜日だけが値を持つので、この式は毎週月曜日から金曜日までの9時30分に実行されます。
日と曜日が同時に値を持つ場合は、解き方が変わります。'0 3 1,15 * 3' を同じように解くと次のとおりです。
- 分: 0、時: 3 → 3時0分
- 日: 1,15 → 毎月1日と15日
- 月: * → すべての月
- 曜日: 3 → 水曜日
日(1, 15)と曜日(水曜日)がどちらも '*' ではないので、ORで結ばれます。したがってこの式は、毎月1日または15日、あるいはその日が水曜日であれば3時0分に実行されます。1か月のうち1日・15日の2日だけでなく、その月のすべての水曜日にも実行されるわけです。
Dynamic Labsの無料ツール「cron式ジェネレーター」で確認する。
式を入力するとブラウザ上ですぐにフィールドごとに解釈され、入力値はサーバーに送信されません。

よく混同しやすい表記のまとめ
cronの表記は、いくつかの規則さえ正確に押さえれば、ほとんど誤解は解けます。とくに次の5つが繰り返し迷うポイントです。
迷いやすいポイント
実際の規則
曜日の「0」と「7」
どちらも日曜日です。別々の曜日ではありません。
日と曜日の同時指定
AND(積集合)ではなくOR(和集合)です。どちらか一方に当てはまれば実行されます。
曜日の「1-5」
専用の「平日」表記があるわけではなく、月(1)から金(5)までの範囲で表現したものです。
'*/15' と '5/15'
'*/15' は0から15きざみ(0, 15, 30, 45)で、'5/15' は5からそのフィールドの最大値まで15きざみ(5, 20, 35, 50)です。開始点が異なります。
'@daily' のようなマクロ
分・時・日・月・曜日の5フィールドに展開した表記ではないため、標準の5フィールド形式とは別に扱われます。
フィールドの値が決められた範囲を外れている場合(例: 分フィールドに60)や、フィールド数が5つでない場合は、有効な式として解釈されません。
まとめ
cron式を読むときに確認すべき点は、次の5つにまとめられます。
- フィールドは常に「分 時 日 月 曜日」の順で5つです。
- '*'・範囲(a-b)・リスト(a,b)・間隔(a/n, */n)はそれぞれ決まった規則に従って値の集合に展開され、コンマで区切られた部分は和集合としてまとめられます。
- 曜日フィールドは0~7の範囲で、0と7のどちらも日曜日を指します。
- 日(day)と曜日を同時に指定すると、ANDではなくORで判定されます。
- 規則自体は手作業でも解けますが、フィールドがいくつも重なる場合は表にまとめてみるほうが速くて正確です。
式を入力するとブラウザ上ですぐにフィールドごとに解釈され、入力値はサーバーに送信されません。
よくある質問
曜日に0と7を両方使ってもいいですか?
はい。曜日フィールドは0から7までの値を受け付け、0と7のどちらも日曜日として扱われます。6は土曜日で、1から5まではそれぞれ月曜日から金曜日です。
日(day)と曜日を一緒に指定したら、両方の条件を満たす必要がありますか?
いいえ。日(day-of-month)と曜日(day-of-week)がどちらも '*' ではない値で埋まっている場合は、OR(和集合)で判定されます。たとえば日に '1,15'、曜日に '3'(水曜日)を指定すると、毎月1日・15日だけでなく、その月のすべての水曜日にも実行されます。
逆にどちらか一方が '*' であれば、そのフィールドは条件から外れ、残りのフィールドだけが適用されます。
'*/15' と '5/15' は同じ意味ですか?
異なります。'*/15' はそのフィールドの最小値(分なら0)から15きざみで飛んで 0, 15, 30, 45 になります。'a/n' の形である '5/15' は、5からそのフィールドの最大値まで15きざみで飛んで 5, 20, 35, 50 になります。開始する値が違うため、結果の値の集合も変わります。
入力した式はサーバーに送信されますか?
いいえ。式の解釈はすべてブラウザ内で処理され、入力した内容がサーバーに送信されたり保存されたりすることはありません。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む