cronスケジュール構文リファレンス

ここでは、 Alteryx Analytics Cloud (AAC) でcronを使用してスケジュールされた実行を定義する構文について説明します。通常、この方法は繰り返しのスケジュールに使用されます。

注記

cronスケジュールを指定している、 AAC ページで定義されたタイムゾーン設定がスケジュールで使用されます。UTCタイムゾーンを使用するには、ドロップダウンで [ UTC] を選択します。

cronの概要

AAC では、広く使用されている構文であるcronを使用して、定期的な間隔での繰り返し時間を指定することができます。cronを使用すると、1分単位または1年単位のスケジュールと、その間の任意の間隔を指定できます。

cron構文

cronスケジュールは、スペースで区切られた文字列の値として定義されます。次のcronの例では、2月1日の午後11時30分にトリガーされるスケジュールを定義しています。

分	時間	月の日	月	曜日
30	23	1	2	*

すべての値が一致すると、cronジョブがトリガーされます。

注記

秒の指定はサポートされていません。

ワイルドカード:

上記のcron式では、ワイルドカード*を使用して任意の許容値を照合できます。これは、そのcron値タイプがこのスケジュールを決定する要因ではないことを意味します。ワイルドカードは曜日の値に適用されているため、スケジュールは任意の曜日にトリガーできます。

注記

曜日フィールドまたは月の日フィールドには、 * 文字を使用する必要があります。同じcron式で両フィールドを指定することはサポートされていません。

凡例:

最後のフィールド(年)を除き、cron式にはすべてのフィールドが必要です。特殊文字については、表の下に記載しています。

値	型	説明	サポートされている特殊文字
30	分	0-59	, - * /
23	時間	0-23	, - * /
1	月の日	1-31	, - * / L W
2	月	1-12	, - * /
*	曜日	0 - 6または日-土 0、日、日=日曜日 1、月、月 =月曜日 ... 6、土、土=土曜日	, - * / L #
*	年	(オプション)必要に応じて年設定を指定できます。既定は*です。	, - * /

特殊文字

cron式では、次の特殊文字を使用できます。

文字	説明
*	( "all values" ) -フィールド内のすべての可能な値に一致するワイルドカード。たとえば、午後10時の1分ごとにトリガーを実行する場合、式中の分の文字は `*` になります。以下は例です。
-	値の範囲を指定します。たとえば、 `1-5` を曜日フィールドに使用すると、週の稼働日(月曜日から金曜日)と一致します。以下は例です。
,	値のセットを個別に指定します。たとえば、月の日フィールドに `1、10、20、30` と指定すると、その月の1日、10日、20日、30日(該当する場合)にトリガーされます。
/	フィールドのユニットでフィールドの増分を指定します。たとえば、分フィールドの `5/20` は、毎時の5分、25分、45分に一致します。
L	範囲内で許容される最後の値は、次のフィールドで許容されます。月の日: 現在選択されている月の値における月の最終日を指定します。 1月であれば、この値は `31` と一致します。 2月であれば、この値は非うるう年の `28` と一致します。 4月であればこの値は `30` と一致します。曜日: 単体では、 `6` (土曜日)と一致する週の最終日を指定します。別の値と一緒に使用すると、その月の最後に一致する値が指定されます。たとえば、 `3L` は月の最後の水曜日です。
W	最も近い一致する平日を指定します。たとえば、月の日フィールドに `22W` と指定すると、22日に最も近い平日に一致します。22日が土曜日の場合、cronジョブは24日(次の月曜日)に一致します。ヒント `LW` は、月の日フィールドで、月の最後の平日に一致させるのに使用できます。
#	月のn番目の日を指定します。曜日フィールドの例: `3#4` -月の第4火曜日 `5#2` -月の第2木曜日

例

以下はcronスケジュールの例です。

毎時

毎時15分に実行:

15 * * * *

毎日

毎日午後10時に実行:

0 22 * * *

毎日午後10時に毎分実行:

* 22 * * *

毎週

毎週火曜日の午前3時に実行:

0 3 * * 2

平日

平日の午後8時に実行:

0 20 * * 1-5

上記のスケジュールでは、月曜日の午後8時に実行され、平日毎晩その時間に実行されます。

毎日平日の朝に実行する場合、日曜日にスケジュールを開始するよう選択することができます。その場合、曜日の値は0で始まり、4で終わります。

毎月

毎月1日の午前2時30分に実行:

30 2 1 * *

その月の25日に最も近い平日(W)の午後3時30分に実行:

30 15 25W * *

25日が土曜日の場合、上記は24日金曜日にトリガーされます。
25日が日曜日の場合、上記は26日月曜日にトリガーされます。

年次

毎年1月1日の正午に実行:

0 0 1 1 * *

その他の例

式	意味
0 12 * * *	毎日夜12時(正午)に実行
15 10 * * *	毎日午前10時15分に実行
15 10 * * *	毎日午前10時15分に実行
15 10 * * * *	毎日午前10時15分に実行
15 10 * * * 2017	2017年の毎日午前10時15分に実行
* 14 * * *	毎日午後2時から午後2時59分まで毎分実行
0/5 14 * * *	毎日午後2時から午後2時55分まで5分ごとに実行
0/5 14,18 * * *	毎日午後2時から午後2時55分まで5分ごとに実行し、毎日午後6時から午後6時55分まで5分ごとに実行
0-5 14 * * *	毎日午後2時から午後2時05分まで毎分実行
10,44 14 * 3 WED	3月の毎週水曜日午後2時10分と午後2時44分に実行
15 10 * * MON-FRI	毎週月曜日、火曜日、水曜日、木曜日、金曜日の午前10時15分に実行
15 10 15 * *	毎月15日の午前10時15分に実行
15 10 L * *	毎月最終日の午前10時15分に実行
15 10 L-2 * *	毎月最終日から2番目の日の午前10時15分に実行
15 10 * * 5L	毎月最終金曜日の午前10時15分に実行
15 10 * * 5L 2017-2019	2017年、2018年、2019年の各月の最終金曜日の午前10時15分に実行
15 10 * * 5#3	毎月第3金曜日の午前10時15分に実行
0 12 1/5 * *	毎月、月の最初から開始して、5日ごとに午後12時(正午)に実行
11 11 11 11 *	毎年11月11日午前11時11分に実行

サポートされていないcron式

注記

AAC では、特殊文字の / と - を同じ式で使用することはできません。

cron構文で範囲を表現する代わりに、可能な選択肢すべてを記述することができます。

無効な式	有効な式
0 23 * 1-11/2 * *	0 23 * 2,4,6,8,10 * *

無効なcron式

式	意味	理由
15 10 * * * 2001	2001年の毎日午前10時15分に実行	このcron式は、イベントを生成できないため無効です。
* * *	-	cron式には、6フィールドまたは7フィールドが含まれている必要があります。

このセクションの内容: