このドキュメントでは、Alibaba Cloud IDaaS EIAM における Cron 式の構文ルールと使用方法について詳しく説明し、スケジュールされたタスクのスケジューリングを正しく設定するのに役立ちます。
Cron 式とは
Cron 式は、スケジュールされたタスクを設定するために使用される時間式です。スペースで区切られた 6 つまたは 7 つのフィールドからなる文字列で構成され、各フィールドは時間単位を表します。
基本構文
Cron 構文フォーマット:
秒 分 時 日 月 曜日 【年】各フィールドの許容値
フィールドの位置
時間単位
値の範囲
使用可能な特殊文字
1
秒
0–59
- * /
2
分
0–59
- * /
3
時
0–23
- * /
4
日
1–31
- * ? / L W C
5
月
1–12 または JAN–DEC
JAN-DEC - * /
6
曜日
0–7 (0 と 7 は両方とも日曜日を表します) または SUN–SAT
SUN-SAT - * ? / L C #
7 (オプション)
年
空または 1970–2199 (オプションのフィールド)
, - * /
特殊文字の説明
文字 | 意味 | 説明 |
* | フィールドのすべての値を表します。 | 分フィールドをアスタリスク(*)に設定すると、タスクは毎分実行されます。 |
? | フィールドのすべての値を表します。この文字は、日フィールドまたは曜日フィールドでのみ使用できます。これらの値は相互に影響を与えるためです。 | 毎月 20 日に曜日に関係なくスケジュールをトリガーするには、 |
- | 値の範囲を表します。 | 分フィールドを 5-20 に設定すると、タスクは 5 分目から 20 分目まで毎分実行されます。 |
/ | 開始時刻と間隔を表します。これらは、この文字で区切られます。タスクは開始時刻に実行され、その後、指定された間隔で実行されます。 | 分フィールドを 5/20 に設定すると、タスクは 1 時間のうち 5 分、25 分、45 分に実行されます。 |
, | 異なる値のリストを表します。 | 分フィールドを 5,20 に設定すると、タスクは 5 分と 20 分に実行されます。 |
L | 最後の日または週を表します。この文字は、日フィールドまたは曜日フィールドでのみ使用できます。 | 曜日フィールドを 5L に設定すると、タスクは月の最終木曜日に実行されます。 |
W | 月曜日から金曜日までの営業日を表します。この文字は、日フィールドでのみ使用できます。タスクは、指定された日付に最も近い営業日に実行されます。 | 日フィールドを 5W に設定し、月の 5 日が土曜日の場合、タスクは最も近い営業日である月の 4 日 (金曜日) に実行されます。月の 5 日が日曜日の場合、タスクは月の 6 日 (月曜日) に実行されます。月の 5 日が営業日の場合、タスクはその日に実行されます。最も近い営業日は当月に限定されます。 |
LW | 月の最終営業日、つまり最終金曜日を表します。 | |
# | 月の n 番目の曜日の発生を表します。この文字は、曜日フィールドでのみ使用できます。 | 曜日フィールドを 4#2 に設定すると、タスクは月の第 2 水曜日に実行されます。ここで、4 は水曜日を示し、2 は 2 回目の出現を示します。 |
一般的な例
IDaaS ID プロバイダーの Cron 式では、少なくとも 1 時間の間隔が必要です。データ同期の頻度が期待どおりになるように、間隔を適切に制御することをお勧めします。
例 | 説明 |
| 2 時間ごとに実行 |
| 毎月 1 日の午前 2 時に実行 |
| 月曜日から金曜日の午前 10:15 に実行 |
| 毎日午後 11 時に実行 |
| 毎日午前 1 時に実行 |
| 毎月 1 日の午前 1 時に実行 |
| 毎月の最終日の午後 11 時に実行 |
| 毎週日曜日の午前 1 時に実行 |
| 毎日午前 12 時、午後 1 時、午後 6 時、午後 9 時に実行 |
| 毎日午前 10 時、午後 2 時、午後 4 時に実行 |
| 毎週水曜日の午後 12 時に実行 |
| 毎日午後 12 時に実行 |
| 毎日午前 10:15 に実行 |
| 毎日午前 10:15 に実行 |
| 毎日午前 10:15 に実行 |
| 2025 年に毎日午前 10:15 に実行 |
| 毎月 15 日の午前 10:15 に実行 |
| 毎月の最終日の午前 10:15 に実行 |
| 毎月の最終金曜日の午前 10:15 に実行 |
| 2025 年から 2026 年まで、毎月の最終金曜日の午前 10:15 に実行 |
| 毎月の第 3 金曜日の午前 10:15 に実行 |
この例の時間パラメーター (年を含む) は、実際のニーズに応じて柔軟に調整できます。