Cronパーサー

Cron式を解析し、妥当性を検証して次回実行時刻を確認します。

よく使うパターン

使用例

バッチジョブが実際いつ実行されるかデプロイ前に確認する

cron式を設定ファイルに書く前に、意図した時刻どおりに実行されるか、次回実行時刻の一覧で事前に確認できます。

複雑な式を平易な言葉で理解する

*/15 8-20 * * 1-5のような式の意味がすぐに分からない場合、自然な文章での説明でその場で理解できます。

動かないcronジョブをデバッグする

予約ジョブが実行されない場合、式を貼り付ければ構文エラーがないかすぐに確認できます。

曜日指定でカンマ区切りと範囲のどちらを使うか決める

曜日フィールドで1,3,5と1-5が同じ意味になるか迷った場合は、両方を試して平易な言葉での説明と次回実行時刻を並べて比較すれば、正確にどう違うのか確認できます。

曖昧な要件を実際に動くcron式に落とし込む

「平日の営業時間中に15分おきに実行」と言われた場合は、プリセットから出発して*/15 9-17 * * 1-5のような形に調整し、次回実行時刻が依頼内容と一致するか確認しましょう。

あるジョブランナーから別のジョブランナーへスケジュールを移行する

レガシーシステムからKubernetesのCronJobやGitHub Actionsのワークフローへ予約タスクを移すときは?旧式の式を貼り付ければ平易な言葉での説明が得られ、新しいプラットフォームのドキュメントと照らし合わせてコピーする前にダブルチェックできます。

秒単位の精度を持つ式が想定どおり解析されるか確認する

0 */30 * * * *のように秒フィールドを先頭に持つオプション対応のスケジューラライブラリを使っている場合は?貼り付けて、標準の5フィールド形式と誤解釈されず6フィールド式として読み取られているか確認できます。

クイックリファレンス

Cron式説明
* * * * *毎分
*/2 * * * *2 分ごと
*/5 * * * *5 分ごと
*/10 * * * *10 分ごと
*/15 * * * *15 分ごと
*/30 * * * *30 分ごと
0 * * * *毎時
0 */2 * * *時ちょうど, 2 時間ごと
0 */3 * * *時ちょうど, 3 時間ごと
0 */6 * * *時ちょうど, 6 時間ごと
0 */12 * * *時ちょうど, 12 時間ごと
0 0 * * *次において実施00:00
30 2 * * *次において実施02:30
0 9 * * *次において実施09:00
0 9,17 * * *次において実施 09:00と 17:00
0 9 * * 1-5次において実施09:00、月曜日 から 金曜日 まで
*/15 9-17 * * 1-515 分ごと, 09:00 と 17:59 の間、月曜日 から 金曜日 まで
0 9 * * 1次において実施09:00月曜日 にのみ
0 0 * * 0次において実施00:00日曜日 にのみ
0 10 * * 6,0次において実施10:00日曜日と 土曜日 にのみ
0 0 1 * *次において実施00:00、月の 1 日目
0 0 15 * *次において実施00:00、月の 15 日目
0 0 1,15 * *次において実施00:00、月の 1と 15 日目
0 0 1 */3 *次において実施00:00、月の 1 日目、3 か月ごと
0 0 1 1 *次において実施00:00、月の 1 日目1月 でのみ

よくある質問

入力した式はサーバーに送信されますか?

いいえ。解析と計算はブラウザ内でのみ行われ、入力した内容がサーバーに送信されることはありません。

秒単位(6フィールド)の式にも対応していますか?

はい。分・時・日・月・曜日の5フィールドの標準cron形式と、先頭に秒フィールドが追加された6フィールド形式の両方を自動的に認識します。

次回実行時刻はどのタイムゾーン基準ですか?

特に設定しない限り、現在使用している端末(ブラウザ)のタイムゾーンを基準に計算します。実際のサーバーのタイムゾーンが異なる場合、その分だけ表示時刻が変わります。

@dailyや@hourlyのようなエイリアスも使えますか?

はい。@yearly、@monthly、@weekly、@daily、@hourlyなどのよく使われるエイリアス表現にも対応しています。

次回実行時刻がおかしい場合、式が壊れているということですか?

必ずしもそうではありません — 最もよくある原因は式の誤りではなくタイムゾーンの不一致です。次回実行時刻はブラウザのローカルタイムゾーンで計算されるため、UTC(または他のどんなタイムゾーン)で動くサーバーに対して完璧に正しい式でも、ここでは異なる時刻で表示されます。式自体が間違っていると決めつける前に、実際のスケジューラがどのタイムゾーンで動いているかを確認し、頭の中で(または手計算で)オフセットを調整してください。

各フィールドの*、,、-、/はそれぞれ何を意味しますか?

*はそのフィールドの「すべての値」を意味します。1,15,30のようなカンマ区切りのリストはその値だけに一致します。9-17のようなハイフンで区切られた範囲はその間のすべての値に(両端を含めて)一致します。*/15や9-17/2のようなスラッシュは、そのフィールドの先頭(または範囲の開始)から「N個おき」を意味します — たとえば分フィールドの*/15は:00、:15、:30、:45に実行されます。これらは0,30 9-17 * * 1-5のように組み合わせることもできます。

日(day-of-month)と曜日(day-of-week)の違いは何ですか?両方指定するとどうなりますか?

5番目のフィールドが曜日(0〜6または名前。0と7はどちらも通常日曜日を意味します)で、3番目のフィールドが日(1〜31)です。両方を同時に*以外に制限すると、ほとんどのcron実装(ここで使われているものも含む)はこれらをOR条件として扱います — つまり両方満たすときではなく、どちらか一方の条件に合えばジョブが実行されます。これは多くの人がつまずくポイントなので、どちらか一方だけを意図している場合は、もう片方を*のままにしておいてください。

年フィールドやL/W文字のような非標準フィールドには対応していますか?

標準の5フィールド形式と秒を先頭に付けた6フィールド形式は、*、範囲、リスト、ステップも含めて完全に対応しています。末尾の年フィールドや、Quartzなどのツールが使う「月の最終日」を意味するL、「最も近い平日」を意味するWといった一部のベンダー固有の拡張は認識されない場合があります。そうした拡張で予期しない解析エラーが出た場合は、対象のスケジューラが本当にその拡張を必要としているか、標準的な代替手段で十分かを確認してみてください。