0 3 * * 1-5 というたった一行で、「平日の午前3時に実行」というスケジュールを表現できる――それがCron式です。Linuxのcrontab、GitHub Actions、Kubernetes CronJob、各種クラウドのスケジューラまで、定期実行の世界はほぼこの文法で動いています。

Cron式の書き方マスターガイド:5つのフィールドと特殊文字を実例で理解する

Cron式を1分で理解する

Cron式は、「分 時 日 月 曜日」の5つのフィールドを空白で区切った書式で、ジョブを実行するタイミングを表します。

  • */5 * * * *:5分ごとに実行
  • 0 3 * * 1-5:平日(月〜金)の午前3時に実行
  • 0 0 1 * *:毎月1日の0時に実行

以降で各フィールドと特殊文字を順に説明します。ほかの式は「よく使うスケジュール例」にまとめています。

この記事では、Cron式の5つのフィールドと特殊文字を実際の式とその意味をセットで見ながら整理します。最後に、現場でハマりやすい落とし穴とよくある質問もまとめました。

Cron式の基本構造:5つのフィールド

標準的なcrontabのCron式は、半角スペースで区切られた5つのフィールドで構成されます。

┌───────────── 分        (0 - 59)
│ ┌───────────── 時      (0 - 23)
│ │ ┌───────────── 日    (1 - 31)
│ │ │ ┌───────────── 月  (1 - 12)
│ │ │ │ ┌───────────── 曜日 (0 - 7, 0と7は日曜)
│ │ │ │ │
* * * * *

各フィールドが取れる値の範囲は次のとおりです。

フィールド 範囲 補足
分 0–59
時 0–23 0が深夜0時、23が23時
日 1–31 月の日付
月 1–12 JAN–DEC も可(環境による)
曜日 0–7 0と7が日曜、1が月曜。SUN–SAT も可

補足: GitHub ActionsやKubernetesも基本はこの5フィールド形式です。一方、Quartzは先頭に「秒」を加えた6フィールド(任意で末尾に「年」を足した7フィールド)、AWS EventBridgeは「分」から始まり末尾に「年」を持つ6フィールド形式を使います。どちらも、後述する ? や L などの特殊文字が必要になります。

特殊文字の意味を実例で理解する

Cron式の表現力は、各フィールドに書ける特殊文字から生まれます。

記号 意味 例 読み方
* すべての値 * * * * * 毎分
, 値の列挙 0 9,12,18 * * * 毎日 9時・12時・18時
- 範囲 0 9-17 * * * 毎日 9時〜17時の毎正時
/ 間隔(ステップ) */15 * * * * 15分おき
? 指定なし(日/曜日用) 0 0 0 ? * MON 毎週月曜0時(日は不問)
L 最終(last) 0 0 0 L * ? 毎月末日の0時
W 直近の平日 0 0 0 15W * ? 15日に最も近い平日
# 第n週の曜日 0 0 9 ? * MON#1 第1月曜の9時

?・L・W・# はQuartz系スケジューラ(QuartzやAWS EventBridgeなど)の拡張で、標準のcrontabでは使えない点に注意してください。この4行の例は、Quartzの6フィールド形式(先頭が秒)で書いています。 QuartzとEventBridgeでは、日と曜日のどちらか一方に必ず ? を書く必要があります(両方に * は指定できません)。同じスケジュールは、それぞれ次のように書きます。

スケジュール Quartz(6フィールド・先頭が秒) AWS EventBridge(6フィールド・末尾が年)
毎週月曜 0時 0 0 0 ? * MON 0 0 ? * MON *
毎月末日 0時 0 0 0 L * ? 0 0 L * ? *
15日に最も近い平日 0時 0 0 0 15W * ? 0 0 15W * ? *
第1月曜 9時 0 0 9 ? * MON#1 0 9 ? * MON#1 *

/(ステップ)の読み方

*/15 は「0から始めて15ごと」、つまり 0,15,30,45 を意味します。範囲と組み合わせると、開始位置を指定できます。

*/15 * * * *     → 0,15,30,45分(15分おき)
5/10 * * * *     → 5,15,25,35,45,55分(5分から10分おき)
0 9-17/2 * * *   → 9,11,13,15,17時(9〜17時の2時間おき)

よく使うスケジュール例

そのままコピーして使える、現場で頻出のパターンです。

やりたいこと Cron式
毎分 * * * * *
5分おき */5 * * * *
毎時0分 0 * * * *
毎日 午前0時 0 0 * * *
毎日 午前9時30分 30 9 * * *
平日 午前3時 0 3 * * 1-5
平日 9〜18時の30分おき */30 9-18 * * 1-5
毎週月曜 午前9時 0 9 * * 1
毎月1日 午前0時 0 0 1 * *
毎月末 午前0時(Quartz系) 0 0 0 L * ?
第1月曜 午前9時(Quartz系) 0 0 9 ? * MON#1

現場でハマりやすい落とし穴

1. 「日」と「曜日」を両方指定するとOR条件になる

0 0 1 * 1 は「1日 または 月曜の午前0時」です。「1日が月曜のとき」というAND条件ではありません。直感に反するため、どちらか一方だけを指定し、もう片方は *(QuartzやEventBridgeでは ? が必須)にするのが安全です。

2. タイムゾーンは実行環境に依存する

多くのcronはサーバーのタイムゾーン、コンテナやCIはUTCで動くことが珍しくありません。0 0 * * * と書いても、JSTの0時ではなくUTCの0時(=JST午前9時)に動く、という事故は頻発します。JSTの深夜2時に動かしたいなら、UTC基準では 0 17 * * * です。

3. 分のフィールドを * にすると毎分実行される

* 3 * * *(毎日3時に1回のつもり)は、3時台の60回実行されます。「3時ちょうどに1回」なら 0 3 * * * です。

4. 短すぎる間隔の重複実行

5分おきのジョブが5分以内に終わらないと、前回が走っている間に次が起動して多重実行になります。処理時間に余裕を持った間隔設定か、ロック機構を検討してください。

ツールで「保存前の不安」を解消する

Cron式は読み書きに慣れが必要で、特に上記の落とし穴は目視では気づきにくいものです。Cron式パーサー では、入力したCron式を日本語の説明に変換し、直近の実行日時をシミュレーションして確認できます。デプロイ前に「本当に意図したスケジュールか」を一目で検証できます。

2026年11月に追加された機能

  • Quartz / Spring の cron を確認するカードを追加しました。秒つきの 6〜7 項目、?・L・L-n・LW・nW・nL・n#k、年に対応し、誤りの指摘・項目ごとの意味・次の 10 回の実行時刻を出します。
  • 曜日の番号は Quartz が日曜 = 1、Spring が日曜 = 0 または 7 で、Spring は日と曜日の両方を指定すると両方に合う日だけ実行します。標準の 5 項目の式を Quartz 用に変換するボタンもあります。

ツールで試す

よくある質問

Cron式の曜日は0と7のどちらが日曜ですか?

多くの実装で0と7の両方が日曜を指します。月曜は1、土曜は6です。混乱を避けるため、SUN MON のような英語3文字表記が使える環境ではそちらを使うと安全です。

「毎月最終日」はどう書きますか?

L をサポートする環境なら、Quartzでは 0 0 0 L * ?、AWS EventBridgeでは 0 0 L * ? * で表せます。標準のcrontabには L がないため、月初に翌月末を計算する、あるいは月末候補日(28〜31日)を実行してスクリプト側で判定する、といった回避策が必要です。

UTCとJSTのずれはどう扱えばよいですか?

JSTはUTC+9です。JSTの時刻からUTCのCron式を作るには時フィールドから9を引きます(マイナスになる場合は前日扱いで+24)。例えばJSTの深夜2時はUTCの前日17時なので 0 17 * * * です。スケジューラにタイムゾーン指定があれば、それを使うのが最も確実です。

*/5 と 0/5 は同じですか?

分フィールドではどちらも「5分おき(0,5,10,…)」で実質同じです。*/5 は「全範囲を5刻み」、0/5 は「0から5刻み」という意味で、開始位置をずらしたいとき(例 7/15)に明示的な開始指定が役立ちます。