Cron 式パーサー

Cron 式は、サーバー、CI ジョブ、自動化プラットフォーム、保守スクリプトで使われるコンパクトなスケジューリング文字列です。強力ですが、小さなタイプミスで毎日実行のジョブが毎分実行になったり、平日から週末に変わったりすることがあります。

このパーサーは Unix の 5 フィールド cron 式を平易な言葉で説明し、各フィールドを分解して、ツールで選択したタイムゾーンを使った今後の実行時刻を表示します。

v1 パーサーは 5 つのフィールドを持つ標準的な Unix cron をサポートします：

minute hour day-of-month month day-of-week

• 分の値は 0 to 59.
• 時の値は 0 to 23.
• 月の日 (day-of-month) の値は 1 to 31.
• 月の値は 1 to 12、および JAN や DEC のような名前を含みます JAN and DEC.
• 曜日 (day-of-week) の値は 0 to 7、および JAN や DEC のような名前を含みます MON and FRI。どちらも 0 and 7 は日曜日を意味します。

ワイルドカード、カンマ区切りリスト、範囲、および */15 や 9-17/2 のようなステップ値をサポートします。 */15 or 9-17/2.

Cron 方言は普遍的ではありません。Quartz、systemd タイマー、クラウドスケジューラ、Kubernetes、GitHub Actions、ホスティングプラットフォームは独自のフィールドや特殊な演算子を追加することがあります。

• 秒フィールドや年フィールドは Unix cron として解析されません。
• Quartz の演算子（例えば ?, L, W、および # ）はサポート対象外として報告されます。
• マクロ（例えば @daily and @reboot 展開されません。
• スケジュールの後のコマンドテキストは式の一部として扱われません。

cron 式自体にはタイムゾーンが含まれません。同じ式でも、サーバーが UTC、ローカルのシステムタイムゾーン、またはスケジューラ固有のタイムゾーン設定を使っているかどうかで異なる瞬間に実行されます。

• プレビューは、選択された IANA タイムゾーンと UTC の実行時刻を表示します。
• サマータイムの「進み（spring-forward）」により、存在しないローカルの壁時計時刻がスキップされることがあります。
• 時計の戻り（フォールバック）によりローカルの同じ壁時計時刻が繰り返されることがあります。スケジューラの挙動は異なる場合があります。
• day-of-month と day-of-week の両方が制限されている場合、Unix cron では一般的に OR の意味論が使われます。

重要なジョブの場合、プレビューは計画支援と考え、スケジューラ自体での挙動を確認してください。