scheduler の書式

トリガーで利用できるスケジュール機能では、自然言語に近い書式で実行スケジュールを定義することが出来ます。 ここでは、スケジュール機能の書式について紹介します。

schedule の書式

[TYPE] [INTERVAL_VALUE] [INTERVAL_SCOPE]

日を指定しない繰り返しの場合

[TYPE]: 日を指定しない繰り返しでは every 接頭辞を含める必要があります。

every 12 hours

[INTERVAL_VALUE]: 整数値とそれに対応する時間の単位。有効な時間の単位は次のとおりです。

  • minutes または mins
  • hours

    10 minutes
    

[INTERVAL_SCOPE]: [INTERVAL_VALUE] に対応する句を指定します。

  • ジョブを実行する具体的な開始時刻と範囲を定義するには、from [HH:MM] to [HH:MM] 句を含めます。 時刻の値は 24 時間形式の HH:MM で指定する必要があります。つまり、それぞれ次のようになります。

    every 5 minutes from 10:00 to 14:00
    every 1 hours from 08:00 to 16:00
    

日を指定したカスタムの指定

[TYPE]: 繰り返しの曜日の順序を指定できます。

  • every
  • 1st または first
  • 2nd または second
  • 3rd または third
  • 最大 5th または fifth まで

[INTERVAL_VALUE]: トリガーを実行する具体的な日付または曜日を含めることができます。リストはカンマ区切りのリストで定義する必要があり、以下のいずれかの値を含めることができます。

  • その月の日付を表す整数値で、最大 31 日まで。たとえば、次のようになります。
    • 1
    • 2
    • 3
    • 最大 31 まで
  • 曜日名を表す次の長い値または省略値の任意の組み合わせ:
    • monday または mon
    • tuesday または tues
    • wednesday または wed
    • thrusday または thurs
    • friday または fri
    • saturday または sat
    • sunday または sun
    • すべての曜日を指定するには、day を使用します。

[INTERVAL_SCOPE]: [INTERVAL_VALUE] に対応する句を指定します。of [MONTH] 句を含め、単一の月または複数の月のカンマ区切りのリストを指定することができます。また、トリガーを実行する具体的な時刻も定義する必要があります。たとえば、 of [MONTH] [HH:MM] のように定義します。 of [MONTH] 句が除外されている場合、毎月実行されます。

  • [MONTH]: 月はカンマ区切りのリストで指定する必要があり、次の長い値または省略値の組み合わせを含めることができます。
    • january または jan
    • february または feb
    • march または mar
    • april または apr
    • may
    • june または jun
    • july または jul
    • august または aug
    • september または sep
    • october または oct
    • november または nov
    • december または dec
    • すべての月を指定するには、 month を使用します。
  • [HH:MM]: 時刻の値は 24 時間形式の HH:MM で指定する必要があります。
    • HH00 から 23 までの整数です。
    • MM00 から 59 までの整数です。

毎日 00:00 に実行する:

every day 00:00

毎週月曜日の 09:00 に実行する:

every monday 09:00

3 月の第 2 水曜日の 17:00 に 1 回だけ実行する:

2nd wednesday of march 17:00

5 月の最初の 2 週の月曜日、水曜日、金曜日の 10:00 に 1 回ずつ、つまり合計で 6 回実行する:

1st,second mon,wed,fri of may 10:00

1 週間に 1 回実行する。毎月 1 日を起点として 7 日ごとの 09:00 に 1 回実行する:

every 1,8,15,22,29 of month 09:00

隔週で実行する。毎月第 1 および第 3 月曜日の 04:00 に 1 回実行する:

1st,third Monday of month 04:00

毎年 3 回実行する。9 月、10 月、11 月の第 1 月曜日の 09:00 に 1 回実行する:

1st monday of sep,oct,nov 09:00

四半期ごとに 1 回実行する。1 月、4 月、7 月、10 月の初日の 00:00 に 1 回実行する:

every 1 of jan,april,july,oct 00:00