定时触发器

定时触发器

该功能需开发者工具 1.02.1811270 及以上版本方可使用 从开发者工具 1.02.1910182 开始，新上传的定时触发器内支持使用云调用

如果云函数需要定时 / 定期执行，也就是定时触发，我们可以使用云函数定时触发器。配置了定时触发器的云函数，会在相应时间点被自动触发，函数的返回结果不会返回给调用方。

在需要添加触发器的云函数目录下新建文件 config.json，格式如下：

{
  // triggers 字段是触发器数组，目前仅支持一个触发器，即数组只能填写一个，不可添加多个
  "triggers": [
    {
      // name: 触发器的名字，规则见下方说明
      "name": "myTrigger",
      // type: 触发器类型，目前仅支持 timer (即 定时触发器)
      "type": "timer",
      // config: 触发器配置，在定时触发器下，config 格式为 cron 表达式，规则见下方说明
      "config": "0 0 2 1 * * *"
    }
  ]
}

字段规则：

• 定时触发器名称 (name)：最大支持 60 个字符，支持 a-z, A-Z, 0-9, - 和 _。必须以字母开头，且一个函数下不支持同名的多个定时触发器。
• 定时触发器触发周期 (config)：指定的函数触发时间。填写自定义标准的 cron 表达式来决定何时触发函数。有关 cron 表达式的更多信息，请参考下面的内容。

Cron 表达式

Cron 表达式有七个必需字段，按空格分隔。

其中，每个字段都有相应的取值范围：

通配符

注意事项

• 在 Cron 表达式中的“日”和“星期”字段同时指定值时，两者为“或”关系，即两者的条件分别均生效。
• 触发器规则的时区为 UTC+8

示例

下面展示了一些 Cron 表达式和相关含义的示例：

• */5 * * * * * * 表示每5秒触发一次
• 0 0 2 1 * * * 表示在每月的1日的凌晨2点触发
• 0 15 10 * * MON-FRI * 表示在周一到周五每天上午10:15触发
• 0 0 10,14,16 * * * * 表示在每天上午10点，下午2点，4点触发
• 0 */30 9-17 * * * * 表示在每天上午9点到下午5点内每半小时触发
• 0 0 12 * * WED * 表示在每个星期三中午12点触发

环境信息

在云函数内，可以通过 getWXContext().SOURCE === 'wx_trigger' 判断调用来源是触发器。（附：所有调用来源列表）

在下一章节，我们一起了解下云函数的运行机制。