# AWS cron 式ビルダーとバリデーター

無料、ブラウザで動作 · EventBridge Scheduler とルール · オフラインでも動作

## 式を作成してチェック

すべてブラウザ内で、オフラインでも動作します。入力した内容はどこにも送信されません。ページのアドレスをコピーすればスケジュールを共有でき、式は # の後ろに保存されます。

Screenshot: Schedules：今日と明日の EventBridge ルールと Scheduler のスケジュールを 1 本のタイムラインに表示

CloudConsole アプリで

## 自分のアカウントで実行する

ここでは式を 1 つチェックし、アプリですべてを確認できます。Schedules は、アカウント内のすべての EventBridge ルールと Scheduler のスケジュールを、今後 24 時間または 7 日間の 1 本のタイムラインに、あなたのタイムゾーンでターゲットとともに表示します。

[Schedules の仕組み → (EN)](https://cloudconsole.dev/app-tools/eventbridge-schedules-timeline)

[App Storeからダウンロード](https://apps.apple.com/app/cloudconsole-for-aws/id6835419710) · [Google Playで手に入れよう](https://play.google.com/store/apps/details?id=com.cloudconsole.app)

**要点**

AWS の cron 式は、分、時、日、月、曜日、年の 6 つのフィールドを `cron()` で囲んだものです。`cron(0 9 ? * MON-FRI *)` は平日の毎日 09:00 に実行されます。2 つの日付フィールドのどちらかは `?` にする必要があり、曜日は 1 = 日曜日〜7 = 土曜日で数えます。EventBridge ルールは UTC で実行され、EventBridge Scheduler は任意のタイムゾーンを使えます。

## AWS cron の構文：6 つのフィールド

EventBridge のスケジュールされたルールと EventBridge Scheduler は同じ cron 形式を使います：`cron(minutes hours day-of-month month day-of-week year)`。6 つのフィールドはすべて必須で、スペースで区切ります。

| フィールド | 値 | ワイルドカード |
|---|---|---|
| 分 | 0–59 | `, - * /` |
| 時 | 0–23 | `, - * /` |
| 日 | 1–31 | `, - * ? / L W` |
| 月 | 1〜12 または JAN〜DEC | `, - * /` |
| 曜日 | 1〜7 または SUN〜SAT（1 = 日曜日） | `, - * ? L #` |
| 年 | 1970–2199 | `, - * /` |

### ワイルドカード

- `,` は値を追加します。月フィールドの `JAN,FEB,MAR` は 1 月、2 月、3 月です。
- `-` は範囲です。日フィールドの `1-15` は 1 日〜15 日です。AWS 自身の例には、時フィールドで深夜 0 時をまたぐ範囲 `20-2` もあります。
- `*` はすべての値です。日と曜日の両方で同時には使えません。
- `/` は増分です。分フィールドの `1/10` は 1 分、11 分、21 分…に実行され、`0/15` は毎時 0 分から 15 分ごとです。曜日では使えません。
- `?` は「任意」を意味し、使わない方の日付フィールドに入れます。日に `7`、曜日に `?` とすると、曜日にかかわらず 7 日に実行されます。
- `L` は最終日です。日フィールドでは月の最終日、曜日フィールドでは週の最終日です。曜日の `6L` は月の最終金曜日です。
- `W` は最も近い平日です。`3W` は月の 3 日に最も近い平日です。
- `#` は月の第 n 曜日です。`3#2` は第 2 火曜日です（3 は週の 3 日目の火曜日）。`#` を含む曜日フィールドにはその式 1 つしか書けないため、`3#1,6#3` は無効です。

どの式にも 2 つの制限があります。日付フィールドを両方指定することはできず（一方は `?`）、1 分に 2 回以上実行される cron 式はサポートされません。

## 例

| 式 | 実行タイミング |
|---|---|
| `cron(0 10 * * ? *)` | 毎日 10:00 UTC |
| `cron(15 12 * * ? *)` | 毎日 12:15 UTC |
| `cron(0 18 ? * MON-FRI *)` | 月曜〜金曜の 18:00 UTC |
| `cron(0 8 1 * ? *)` | 毎月 1 日の 08:00 UTC |
| `cron(0/15 * * * ? *)` | 15 分ごと |
| `cron(0/10 * ? * MON-FRI *)` | 月曜〜金曜に 10 分ごと |
| `cron(0/5 8-17 ? * MON-FRI *)` | 月曜〜金曜の 08:00〜17:55 UTC に 5 分ごと |
| `cron(15 10 ? * 6L 2019-2022)` | 2019〜2022 年の毎月最終金曜日の 10:15 UTC |
| `cron(0 12 ? * 3#2 *)` | 毎月第 2 火曜日の 12:00 |
| `cron(0 9 15W * ? *)` | 15 日に最も近い平日の 09:00 |

最初の 8 つは AWS のドキュメントからの例です。EventBridge ルールでは時刻は UTC、EventBridge Scheduler ではスケジュールのタイムゾーンです。

## AWS cron と Unix cron の違い

crontab の行はそのままでは動きません。ビルダーに貼り付けると、AWS 版を提案します。

| 違い | Unix cron | AWS cron |
|---|---|---|
| フィールド | 5 つ：分、時、日、月、曜日 | 6 つ：同じ 5 つに**年**を加え、`cron( )` で囲む |
| 日と曜日 | 両方指定でき、両方を制限した場合はどちらかが一致すれば実行 | どちらかは `?` にする必要があり、両方は制限できない |
| 日曜日 | 0（多くの実装では 7 も）。曜日は 0〜6 | 1。曜日は 1〜7、SUN〜SAT |
| 5 分ごと | `*/5 * * * *` | `cron(0/5 * * * ? *)` または `rate(5 minutes)` |
| 曜日での増分 | 多くの実装で使用可 | 使用不可：曜日を列挙する |
| L、W、# | 標準の cron にはない | 最終日（`L`、`6L`）、最も近い平日（`15W`）、第 n 曜日（`3#2`） |
| タイムゾーン | サーバーのタイムゾーン | EventBridge ルールは UTC。EventBridge Scheduler はスケジュールごとに任意の IANA タイムゾーン |

どちらにも秒のフィールドはありません。Quartz と Spring の式には秒があるので、最初のフィールドを削除すると AWS の形式になります。

## rate() 式

一定の間隔なら `rate(value unit)` の方が簡単です：`rate(5 minutes)`、`rate(1 hour)`、`rate(12 hours)`、`rate(1 day)`。値は正の整数、単位は分、時間、日のいずれかで、秒、週、月はありません。

- **EventBridge ルール**では、値が 1 のときは単数形、1 を超えるときは複数形の単位が必要です。`rate(1 hour)` と `rate(5 hours)` は有効、`rate(1 hours)` と `rate(5 hour)` は無効です。
- **EventBridge Scheduler** のガイドは単位を `minutes | hours | days` と記載し、本文でも `rate(1 days)` と書いています。

rate スケジュールは時計ではなく開始時点から数えます。ルールを作成した時点、または Scheduler のスケジュールの `StartDate` からです（指定がなければすぐに呼び出しを始めます）。特定の分に実行する必要がある場合は cron を使ってください。

## タイムゾーンと夏時間

**EventBridge ルール**は cron を UTC で評価し、AWS の例もすべて UTC+0 です。ニューヨーク時間の 09:00 に実行するには、UTC の時刻を自分で計算し、時計の切り替え時に変更する必要があります。

**EventBridge Scheduler** は、cron と 1 回限りのスケジュールを、スケジュールに指定したタイムゾーン（`--schedule-expression-timezone`、CloudFormation では `ScheduleExpressionTimezone`、IANA タイムゾーンデータベースの名前）で評価し、夏時間を考慮します：

- 時計が進むときは、存在しない 1 時間に当たる実行はその日スキップされます。
- 時計が戻るときは、2 回ある時刻は 2 回目に 1 回だけ実行されます。
- `rate(1 days)` は 24 時間を意味するため、23 時間や 25 時間の日には時計に対して 1 時間ずれます。

ビルダーはこれらのルールに従い、スキップされる時刻や重複する時刻に印を付けます。Scheduler はターゲットを 60 秒の精度で呼び出します。1:00 の実行は、柔軟な時間枠を設定しない限り 1:00:00〜1:00:59 の間に行われます。

## 1 回限りのスケジュール：at()

EventBridge Scheduler は、指定した時刻にターゲットを 1 回だけ呼び出すこともできます：`at(2026-12-31T23:30:00)`（スケジュールのタイムゾーン）。EventBridge ルールはこれに対応していません。1 回限りのスケジュールは実行後もスケジュールのクォータに数えられるため、AWS は実行後に削除することを推奨しています。

## 出典

- [Amazon EventBridge User Guide: Setting a schedule pattern for scheduled rules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html)
- [EventBridge Scheduler User Guide: Schedule types (time zones and daylight saving time)](https://docs.aws.amazon.com/scheduler/latest/UserGuide/schedule-types.html)
- [CloudFormation: AWS::Scheduler::Schedule](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-scheduler-schedule.html)
- [CloudFormation: AWS::Events::Rule](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-events-rule.html)

## よくある質問

### AWS で「Parameter ScheduleExpression is not valid」と表示されるのはなぜですか？

EventBridge は式全体をチェックし、どこかがルールに違反していればこの ValidationException で拒否します。よくある原因は、6 つではなく 5 つのフィールド、日と曜日の両方に *（一方は ? が必要）、日曜日を 0 と書く（AWS は日曜日から 1〜7 で数える）、曜日での / の増分、rate(1 minute) ではなく rate(1 minutes) と書くことです。上のビルダーに式を貼り付けると、どのフィールドが誤っているかわかります。

### AWS cron は UTC ですか？

EventBridge のスケジュールされたルールでは、はい。式は常に UTC で評価されます。EventBridge Scheduler では、スケジュールごとにタイムゾーン（ScheduleExpressionTimezone、Asia/Tokyo などの任意の IANA 名）を設定でき、夏時間も考慮されます。指定しない場合は UTC です。

### Lambda 関数を 5 分ごとに実行するには？

rate(5 minutes) または cron(0/5 * * * ? *) を使います。EventBridge Scheduler では、関数をターゲットとし、Scheduler が引き受けられるロールを指定してスケジュールを作成します。EventBridge ルールでは、関数をターゲットに追加し、aws lambda add-permission で EventBridge に呼び出しの権限を与えます。

### AWS cron 式の ? は何を意味しますか？

「任意」です。AWS cron には日と曜日の別々のフィールドがあり、両方を制限することはできないため、使わない方を ? にする必要があります。たとえば cron(0 9 ? * MON *) は毎週月曜日、cron(0 9 1 * ? *) は毎月 1 日に実行されます。

### EventBridge のスケジュールを 1 分に 2 回以上実行できますか？

いいえ。1 分未満の頻度になる cron 式はサポートされず、rate() で使える単位は分、時間、日です。また、EventBridge Scheduler はターゲットを 60 秒の精度で呼び出すため、1:00 のスケジュールは 1:00:00〜1:00:59 の間に実行されます。

### ビルダーは式をどこかに送信しますか？

いいえ。解析と実行時刻の計算は、タイムゾーンの変換も含めてブラウザ内で行われ、変換にはブラウザ内蔵のタイムゾーンデータを使います。入力した内容はどこにも送信されず、このページは Cookie を使いません。

**スケジュールされたジョブが深夜 3 時に失敗したら**

EventBridge、Lambda、CloudWatch のアラームとログには CloudConsole の専用画面があるので、どのアラームが発火したかを確認し、その実行のログをスマホで読めます。iPhone と Android に対応。

[アプリについて →](https://cloudconsole.dev/ja/aws-console-app)

## 関連ページ

- [CloudWatch アラーム：EventBridge Scheduler InvocationDroppedCount (EN)](https://cloudconsole.dev/alarms/eventbridge-scheduler-invocationdroppedcount) – CloudWatchアラーム
- [CloudWatch アラーム：EventBridge Scheduler TargetErrorThrottledCount (EN)](https://cloudconsole.dev/alarms/eventbridge-scheduler-targeterrorthrottledcount) – CloudWatchアラーム
- [aws lambda add-permission (EN)](https://cloudconsole.dev/cli/lambda-add-permission) – AWS CLI
- [Lambda: Task timed out after 3.00 seconds (EN)](https://cloudconsole.dev/errors/lambda-task-timed-out) – AWS エラーの解決
- [AWS ARN パーサー](https://cloudconsole.dev/ja/tools/arn-parser) – 無料ツール
- [AWS レイテンシーテスト](https://cloudconsole.dev/ja/tools/aws-latency-test) – 無料ツール

---

Source: https://cloudconsole.dev/ja/tools/eventbridge-cron-builder

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
