crontab 説明変換 — `0 9 * * 1-5` を「平日 9:00」に

cron 式が「読みにくい」からこそ、外に出さずに確認したい

crontab の 5 フィールド形式は慣れた開発者にも直感的ではありません。0 3 */2 * 1-5 が「平日の 2 日おきの午前 3 時」なのか「平日の月曜から金曜の 2 時間おきの 3 分」なのかは、フィールドの順序を知らないと即座に読み取れません。この読みにくさが「オンラインで確認したい」という動機を生みますが、確認対象の cron 式は本番サーバー・CI/CD パイプライン・Kubernetes CronJob から取ってきたものである場合がほとんどです。

本番の crontab の内容は、サービスの定期処理スケジュール・バックアップタイミング・データ同期の頻度という業務情報を含みます。「この式の意味を確認したい」という動機でオンラインサービスに貼り付けることで、そのシステム構成が外部に出ます。

cron 式に含まれる業務情報を外部サービスに渡さない

GitHub Actions のプライベートリポジトリの .github/workflows/*.yml に書かれた cron スケジュール、Kubernetes の spec.schedule、Vercel の vercel.json の cron 設定は、いずれも内部の運用情報です。これらを「説明してもらうため」に外部のサービスに送信すると、cron 式に含まれる業務ロジックの断片が外部サーバーのログに残ります。

cron の説明生成は、5 フィールドの各数値・記号を日本語または英語の文章に変換するだけの処理です。自前パーサーで実装すればサーバー処理は不要で、説明文の生成もブラウザ内で完結します。

自前パーサーによるブラウザ内完結の説明生成

本ツールは POSIX 5 フィールド・Spring/Quartz/GitLab 6 フィールド・Quartz 7 フィールドの各バリアントを自前パーサーで解析します。外部ライブラリに依存せず、正規表現と文字列処理のみで各フィールドの範囲・リスト・ステップ・エイリアス (@daily → 0 0 * * *) を解釈します。説明文は ja / en の 2 言語で、フィールドの意味を組み合わせた自然言語文として生成されます。

入力した cron 式はページメモリ内にのみ存在し、DevTools の Network タブを開いた状態で式を入力・変更しても送信リクエストは発生しません。フィールド内訳テーブルの表示もすべてローカル計算の結果です。

cron-next との組み合わせで完全理解

「この式の意味は何か」を理解するのが本ツール (crontab-explain)、「次にいつ動くか」を確認するのが cron-next ツールです。両方をブラウザのタブで並べて使うと、cron 式の理解とデバッグが外部サービスなしに完結します。特に Kubernetes CronJob や GitHub Actions のスケジュールを変更するとき、変更前後の式を両ツールで確認することで、意図しないスケジュール変更を事前に防げます。

自前パーサーが正規表現と再帰下降で扱うフィールド構造

cron 式の各フィールドは構造化された記法を持ちます。本ツールのパーサーは正規表現と単純な再帰下降で各要素を分解しています。基本要素は: 数値 (5)、範囲 (1-5)、ステップ (*/15 または 1-30/2)、リスト (0,15,30,45)、ワイルドカード (*)、エイリアス (MON / JAN のような名前付きトークン、または @daily のような特殊エイリアス)。これらを「フィールド全体」として連結する , 区切りリストの中にも再帰的に出現できるため、0,5-10,*/30,MON のような複合パターンも正しく分解する必要があります。

説明文の生成は、各フィールドの意味を Σ <時間表現> + <条件表現> の形で組み合わせます。0 9 * * 1-5 であれば「分: 0 (毎時 0 分)」+ 「時: 9 (午前 9 時)」+ 「日: * (毎日)」+ 「月: * (毎月)」+ 「曜日: 1-5 (月曜から金曜)」を、人間が自然に読める順序で再構成して「平日 (月-金) の 9:00」と出力します。リスト・範囲・ステップ・名前付きトークンの組み合わせは指数的にケースが増えるため、フィールドの意味付け関数が独立して動くよう設計されています。

crontab ファイル形式の周辺仕様: 環境変数・シェル・特殊コメント

実際の crontab -e で編集するファイルは、cron 式そのもの以外にも複数の規約を持ちます。最初の数行に SHELL=/bin/bash、PATH=/usr/local/bin:/usr/bin:/bin、MAILTO=admin@example.com のような環境変数定義を書け、これは以降のジョブすべてに適用されます。MAILTO="" (空文字) を指定すると、ジョブの stdout / stderr 出力時のメール送信を抑制できます — これを忘れて本番のスパムフィルタにメールが殺到するのは cron の古典的な落とし穴です。

Vixie cron は # で始まる行をコメントとして扱いますが、cron 式の途中に # を埋め込むことはできません (Quartz の # 特殊文字とは異なる)。% (パーセント) には独特の規約があり、cron 式の後ろのコマンド部分で % は改行に変換され、最初の % までが実際のコマンド、その後ろが標準入力として渡されるという奇妙な仕様があります (echo Hello %World は echo Hello を実行し、stdin に World を流す)。% を文字どおりのパーセント記号として使いたい場合は \% とエスケープが必要で、date +%Y%m%d のような日付フォーマット指定が crontab 内で動かない代表的な理由がこれです。本ツールは cron 式そのものの説明に専念し、これらの周辺規約は扱いませんが、デバッグ時にはこの周辺仕様も確認対象になります。コマンド部の date +%Y%m%d を理解するために実際の指定子を別画面で確認したい場合は date-format-pattern が strftime / dayjs の両系統に対応し、cron が示す「次に動く時刻」を Asia/Tokyo や UTC で並べて見たい場合は timezone-info で IANA タイムゾーンと現在オフセットを突き合わせられます。