一、新建 config.json
1. 新建 config.json
在需要添加触发器的云函数目录下新建文件config.json
,格式如下:
{
// triggers 字段是触发器数组,目前仅支持一个触发器,即数组只能填写一个,不可添加多个
"triggers": [
{
"name": "myTrigger",
// type: 触发器类型,目前仅支持 timer (即 定时触发器)
"type": "timer",
// config: 触发器配置,在定时触发器下,config 格式为 cron 表达式,规则见下方说明
"config": "0 0 2 1 * * *"
}
]
}
在云函数的event
中我们可以获取到定时器的信息。所以可以通过判断event.Type
等于timer
来判断是定时器触发的,通过event.TriggerName
来判断是哪一个定时器。
2. 定时器Cron表达式详解
Cron
表达式是一个字符串
,字符串以5
或6
个空格
隔开,分为6
或7
个域,每一个域代表一个含义,Cron有如下两种语法格式。
基本格式
// 格式一
Seconds Minutes Hours DayofMonth Month DayofWeek Year
// 格式二
Seconds Minutes Hours DayofMonth Month DayofWeek
各字段的含义
字段 | 允许值 | 允许的特殊字符 |
---|---|---|
秒(Seconds) | 0~59的整数 |
, - * /
|
分(Minutes) | 0~59的整数 |
, - * /
|
小时(Hours) | 0~23的整数 |
, - * /
|
日期(DayofMonth) | 1~31的整数(但是你需要考虑你月的天数) |
, - * / ? L W C
|
月份(Month) | 1~12的整数或者 JAN-DEC |
, - * /
|
星期(DayofWeek) | 1~7的整数或者 SUN-SAT (1=SUN) |
, - * / ? L C #
|
年(可选 )(Year) |
1970~2099 |
, - * /
|
关于特殊字符的意义
字符 | 含义 | 实例 |
---|---|---|
* |
匹配该域的任意值。比如在Seconds 域使用*, 即表示每秒钟 都会触发事件。 |
|
- |
表示范围。比如在Minutes域使用5-20,表示从5分到20分钟每分钟触发一次。 | |
/ |
表示起始时间开始触发,然后每隔固定时间触发一次。例如在Minutes 域使用5/20 ,则意味着5分钟触发一次,然后每个20分钟触发一次。 |
*/5 * * * * * 表示每五秒钟执行一次。 |
? |
只能用在DayofMonth 和DayofWeek 两个域。它也匹配域的任意值,但实际不会。因为DayofMonth 和DayofWeek 会相互影响。例如想在每月的20日触发调度,不管20日到底是星期几,则只能使用如下写法: 13 13 15 20 * ? , 其中最后一位只能用? ,而不能使用* ,如果使用* 表示不管星期几都会触发,实际上并不是这样。 |
二、实例讲解
1、每隔2小时执行一次
0 0 */2 * * *
2、如何表达每隔90秒执行一次?
有的人觉得可以用*/90 * * * * *
来表示,实际上是行不通的。斜杠后面的数字不能超过正确的时间表示。表如秒,最多就60,你赋予大于60的数字不会生效。
虽然*/2表示的意思是每两小时执行一次,但是你要记得把秒和分的位设为0(或者其它某个固定的数字)。否则用* * */2 * * *
达不到预期效果。
比如有两个定时器:
1:*/5 * * * * *
2: 10/5 * * * * *
这两个定时器都是5秒钟触发一次,但是区别在于第一次的执行时间不一样。第一个定时器在执行后就会触发,然后每隔5秒钟触发一次。而第二个定时器必须要在X分10秒时第一次触发,然后每隔5秒钟触发一次。
三、上传触发器
这一步很多人都遗忘了,导致触发器没有生效!!!
三、定时触发器入参说明
定时触发器在触发函数时,会把如下的数据结构封装在event
里传给云函数。同时,定时触发器支持自定义传入Message
,缺省为空。
{
"Type":"Timer",
"TriggerName":"myTrigger",
"Time":"2019-02-21T11:49:00Z",
"Message":""
}