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

公開ツールcron式ジェネレーター

目次
  1. 5つのフィールドの順序はいつも同じ
  2. アスタリスク、アスタリスク/N、数値の3つだけ分かれば全部読めます
  3. 手で書くと、こんなことが起きます
  4. 日と曜日を一緒に書くと生まれる落とし穴
  5. タイムゾーンが違うと、まったく違う時刻に実行されます
  6. まとめ
  7. よくある質問

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に登録して翌日ログを見てから、合っていたか間違っていたかに気づくというのもよくある話です。

cron式ジェネレーター

分・時・日・月・曜日をドロップダウンで選ぶだけで、標準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が動くサーバー・スケジューラのタイムゾーンを基準に決まるので、登録前のタイムゾーン確認が必要です。
  • 曜日の数値範囲は実装ごとに差があるので、数字より曜日名を基準に確認したほうが安全です。
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は、アスタリスク(*)が作る全範囲の上に一定間隔の条件を重ねたものです。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. cron式の読み方:5フィールドで実行日時を判断cron式の5つのフィールドが「*」や範囲・リスト・間隔の各記法で何に一致するのか、曜日の0と7がどちらも日曜日になる理由、日と曜日を同時に指定したときにORで判定される仕組みを例で確認できます。
  2. EAN-13チェックデジットの計算方法と880の意味EAN-13の13桁目は、前12桁から計算するチェックデジットです。1と3を掛けて手計算で検算する手順と、先頭880が原産地ではなく番号を発行したGS1の会員機関を示すことを整理しました。
  3. ファンタジー名前ジェネレーターの仕組み、種族ごとに音が違う理由エルフは柔らかく、オークは粗い理由から、ドワーフ・人間の名前によく使う「-ton」「-smith」が実際の英語の地名・姓に由来する話まで、種族ごとの名前の音の規則をまとめました。
  4. 抽選の偏りを確認する方法|同じ条件で繰り返し比較抽選プログラムが特定の人や番号ばかり引く気がするとき、同じ条件で何度も繰り返して結果を比べ、偏りがあるかを自分で確かめる手順をまとめました。モジュロ偏りや「重複なし」オプションの意味も解説します。
  5. gitignore が効かない原因と追跡解除の手順gitignore に書いたのにファイルが追跡されるのは、すでに Git が管理しているためです。原因を切り分ける2つのコマンド、git rm --cached での解除、スラッシュ・アスタリスク・否定の書き方を解説します。
  6. SHA-256ハッシュ値でデータ改ざんを確認する方法SHA-256ハッシュが実際に何を計算しているのか、雪崩効果と一方向性の原理から説明し、ブラウザでテキストのハッシュ値を確認する手順を紹介します。

関連ツール