cron は Unix 系システムで繰り返しジョブをスケジュールする仕組みで、その式の形式は crontab にとどまらず、CI パイプライン、Kubernetes CronJob、各種クラウドスケジューラでも使われます。構文は最初こそ難解に見えますが、実は空白で区切られた 5 つのフィールドです。
5 つのフィールド
┌── 分 (0–59)
│ ┌── 時 (0–23)
│ │ ┌── 日 (1–31)
│ │ │ ┌── 月 (1–12)
│ │ │ │ ┌── 曜日 (0–7、0 と 7 は日曜)
│ │ │ │ │
* * * * *各フィールドは「どの値で実行するか」を答えます。* は「すべて」を意味します。つまり * * * * * は毎分実行です。
フィールド内の構文
*——すべての値。5——ちょうど 5。1-5——範囲、1 から 5。*/15——間隔:15 ごと(0、15、30、45)。1,15,30——特定の値のリスト。- 名前——月は
JAN–DEC、曜日はSUN–SAT。
すぐ使える例
| 式 | 意味 |
|---|---|
* * * * * | 毎分 |
*/5 * * * * | 5 分ごと |
0 * * * * | 毎時 0 分 |
0 9 * * * | 毎日 09:00 |
0 9 * * 1-5 | 平日 09:00 |
0 0 * * 0 | 毎週日曜の深夜 |
0 0 1 * * | 毎月 1 日 |
30 3 1 1 * | 1 月 1 日 03:30 |
唯一の落とし穴:日 vs 曜日
「日」と「曜日」の両方が限定されている(* でない)場合、cron はどちらかが一致したときに実行します——両方ではありません。だから 0 0 13 * 5 は毎月 13 日および毎週金曜に発火し、「13 日の金曜」だけではありません。迷ったら実際の実行時刻で確認しましょう。
本番前に検証を
cron を信頼する最も安全な方法は、「実際に発火する時刻」を見ることです。Cron 式ジェネレーターは各フィールドを分かりやすく説明し、ローカル時間での次回実行時刻を一覧表示します。ワンクリックのプリセットもあり、すべてブラウザ内で動作します。
関連ツール
- Unix タイムスタンプも扱うならタイムスタンプ変換。
ショートカット文字列
多くの cron は、5 つのフィールドの代わりに名前付きショートカットを受け付けます:
| ショートカット | 相当する式 | 実行タイミング |
|---|---|---|
@yearly(または @annually) | 0 0 1 1 * | 年 1 回、1 月 1 日 |
@monthly | 0 0 1 * * | 毎月 1 日 |
@weekly | 0 0 * * 0 | 毎週日曜 |
@daily(または @midnight) | 0 0 * * * | 毎日深夜 |
@hourly | 0 * * * * | 毎時 |
@reboot | —— | 起動時に 1 回 |
フィールド数の違いにも注意しましょう。Spring の @Scheduled、Quartz、一部のクラウドスケジューラは先頭に秒フィールドを足して 6 つになり、AWS EventBridge は 6 フィールド形式で「日」と「曜日」の同時指定を禁止しています。5 フィールドの式を 6 フィールドのパーサーに貼ると、まるごと 1 つずれます。
タイムゾーンとサマータイム
古典的な crontab にはタイムゾーンのフィールドがなく、サービスが動くマシンのローカル時間で発火します。Linux ではファイルに CRON_TZ=UTC(または TZ)の 1 行を書いて上書きでき、多くのクラウドスケジューラは代わりにタイムゾーンの選択肢を用意しています。地域をまたいで共有するものは、誰も時差を計算せずに済む UTC が安全な既定値です。
サマータイムの切り替えは典型的な落とし穴です。時計が進むと、飛ばされた 1 時間に入るジョブ(例:30 2 * * *)はその日実行されないことがあり、戻ると、重複する 1 時間のジョブは 2 回走ることがあります。重要なジョブは 01:00–03:00 の外に置くか、UTC で動かしましょう。エポック秒も扱うなら、Unix タイムスタンプ完全ガイドがそれらと壁時計の時刻の対応を解説しています。
手早い FAQ
- 範囲と間隔は組み合わせられる? はい——
0-30/10は 0・10・20・30 です。 - 「時」フィールドの
*/2の意味は? 1 時間おき:0・2・4⋯22。 - cron は逃したジョブを後で実行する? しません。予定時刻にマシンが停止していれば、素の cron は単に飛ばします——追いかけ実行が要るなら
anacronを。