Cron 作业格式和时区

Cron 作业按周期性间隔进行安排，使用 已开启 unix-cron. 您可以定义时间表，让您的作业每天运行多次，或在 特定日期和月份（尽管我们不再推荐使用 App Engine Cron 语法是 仍支持现有作业）。

Cron 作业格式

您可以使用 Google Cloud 控制台、 Google Cloud CLI 或 Cloud Scheduler REST API 设置时间表。

时间表使用 unix-cron 字符串格式 (* * * * *) 来定义，该格式 5 个字段组成的集合，表示应在何时执行作业。

时间字段具有以下格式和可能的值，并且必须遵循 此订单：

|------------------------------- Minute (0-59)
|     |------------------------- Hour (0-23)
|     |     |------------------- Day of the month (1-31)
|     |     |     |------------- Month (1-12; or JAN to DEC)
|     |     |     |     |------- Day of the week (0-6; or SUN to SAT; or 7 for Sunday)
|     |     |     |     |
|     |     |     |     |
*     *     *     *     *
字段 有效值的范围
分钟 0-59
小时 0-23
日期 1-31
月 1-12（或 1-12 月）
周几 0-6（或 SUN 到 SAT；或 7 表示周日）

  • 分钟：表示作业运行到当天零点后的分钟数。例如，如果将分钟设置为 0，则作业会在整点运行（因为这是整点过后的 0 分钟）。因此，如果 是上午 8:00，则作业在上午 8:00 运行。

  • Hour：表示作业运行到凌晨之后经过的时长（以小时为单位，向下舍入到最接近的小时，因为剩余分钟数显示在 minute 字段中）。午夜是0，中午是12。例如，如果将小时设置为 0，则作业会在午夜运行（因为这是午夜过后 0 小时）。

  • 日期：表示月份的日历日期。例如： 1（每月第一天）。Cloud Scheduler 不支持将 L 用作当月的最后一天。

  • 月：表示月份。请指定月份数或前三个 月份名称对应的字母（以大写形式表示）。例如，1 表示 1 月，或 等同于 JAN。

  • 星期几：表示星期几。周一是1，周二 为 2，依此类推。0 或 7 都可以表示星期日。您可以通过数字或星期名称的前三个字母（大写）来指定星期几（例如，SUN 表示星期日）。

    • 此字段会与 day of the month 字段一起作为包含 OR 进行评估，除非其中一个字段被星号 (*) 标记为不受限制。例如，如果日期字段设置为 1，而周几字段设置为 SAT，则作业会在每月第一天和每月每个星期六运行，即使每月第一天不是星期六也是如此。如果星期不受限制（设为 *），作业将仅在每月第一天运行。

匹配所有值

若要匹配某个字段的所有值，请使用星号：*。将某个字段设置为星号后，只要满足其他字段条件，该字段就会与该字段的所有有效值匹配。将字段设置为星号 有时也称为将该字段保留为“unrestricted”，因为它并非 并限制为特定值

下面是两个分钟字段不受限制的示例：

  • * 0 1 1 1：作业会在 1 月 1 日和周一午夜的每分钟运行。
  • * * * * *：作业每分钟运行一次（每小时、每月、每周、每天，因为这些字段也未受到限制）。

星号等同于范围的一种特殊情况，其中 范围从字段的第一个有效值开始，到字段的最后一个有效值结束 字段的值（例如，0-59 表示分钟字段）。

匹配范围

如需匹配一组值，请指定起始值和结束值，并以英文短划线 (-) 分隔。请勿在范围中添加空格。范围包括边界值。第一个数字必须小于第二个数字。如果您使用月份或星期的缩写名称（例如，将年初第一个月表示为 JAN，而不是 1），则第一个值必须在月份或周内早于第二个值。

以下等效示例在星期一、星期二、 星期三、星期四和星期五（适用于所有月份）：

  • 0 0 * * 1-5
  • 0 0 * * MON-FRI

匹配列表

列表可以包含字段的任何有效值，包括范围。指定值，以英文逗号 (,) 分隔。列表中不得包含空格。

示例：

  • 0 0,12 * * *：作业在午夜和中午运行。
  • 0-5,30-35 * * * *：作业在每 半小时（从整点开始和整点过半时）。

跳过范围中的值

您可以通过指定遍历范围的步进速率来跳过范围中的值。这有时称为使用步长函数（或步长值或速率表达式）。为此，请指定范围，后跟正斜线 (/) 和您希望跳过该范围的速率。

您可以使用星号 (*) 来指示 字段。使用星号时，范围中的第一值为：分钟、小时和星期几（星期日）字段为 0，日期和月份字段为 1。

步长值不得大于该字段的最大可能值。 默认步长为 1，因此步进函数 /1 与不使用步进函数相同。

使用步进函数的范围示例：

  • */2：对于任何字段而言，这是有效的单步函数。对于分钟字段， 匹配 0、2、4、...、58。对于小时，它与 0、2、4、...、22 匹配。对于 几号，则匹配 1、3、5、...、31（表示一个月中有 31 天）。对于这个月，它匹配 1、3、5、...、11。对于星期几 就可以匹配 0、2、4、6。

  • 0-12/2：这是适用于分钟和小时字段的有效单步函数。它与 0、2、4、...、12 匹配。

使用阶梯函数的时间表示例：

  • */2 * * * *：作业每两分钟运行一次。

  • 0 0-12/2 * * *：作业每两小时每小时运行一次。首次运行时间为午夜。最后一次运行时间为中午。

示例时间表

下表显示了一些示例 cron 作业时间表及其说明：

时间表 Cron 作业格式 说明
每分钟 * * * * * 每分钟运行一次。例如，上午 9:00、上午 9:01、上午 :02 和 依此类推。
每小时 0 * * * * 每小时运行一次。例如，上午 9:00、上午 10:00、上午 11:00 等 。
每天 0 0 * * * 每天凌晨 12:00（以 24 小时制表示为 00:00）运行。
每个工作日
（周一至周五）		 以下表达式是等效的：
  • 0 0 * * 1-5
  • 0 0 * * MON-FRI
 在星期一、星期二、星期三、星期四和星期五凌晨 12:00（以 24 小时制表示为 00:00）运行。
每周 以下表达式是等效的：
  • 0 0 * * 0
  • 0 0 * * 7
  • 0 0 * * SUN
 星期日凌晨 12:00（00:00，采用 24 小时制）运行。
每月 0 0 1 * * 第一天午夜 12:00（24 小时制的 00:00）运行 。
每季度 以下表达式是等效的：
  • 0 0 1 1,4,7,10 *
  • 0 0 1 JAN,APR,JUL,OCT *
 第一天午夜 12:00（24 小时制的 00:00）运行 季度，对于标准季度时间表：1 月 1 日、4 月 1 日、7 月 和 10 月 1 日
每年 以下表达式是等效的：
  • 0 0 1 1 *
  • 0 0 1 JAN *
 第一天午夜 12:00（24 小时制的 00:00）运行 一年的第一个月（1 月 1 日）。

时区

您可以在以下位置选择用于评估时间表的时区： Google Cloud 控制台（在创建作业页面上，选择时区，从 列表），或通过 gcloud --time-zone标记 创建作业。

此字段的值必须是 tz 数据库。 默认时区为 UTC。

对于某些时区，夏令时可能会导致作业运行或无法运行 。这是因为 Cloud Scheduler 按挂钟时间运行 。如果某一时间可能出现两次（例如时钟回拨的情况），而您的作业安排在此时间，则预定作业的执行可能会有异常。

如果您的作业需要非常特定的节奏，则可能需要考虑选择不采用夏令时的时区。具体来说，建议 Cloud Scheduler 使用 UTC，以完全避免该问题。