详情页标题前

腾讯云云函数(SCF)定时触发器说明-云淘科技

详情页1

用户可以编写 SCF 函数来处理定时任务(支持秒级触发)。定时器会在指定时间自动触发 SCF 函数。定时触发器具有以下特点:Push 模型:定时器指定时间到达时直接调用相关函数的 Invoke 接口来触发函数。该事件源映射关系保存在 SCF 函数中。异步调用:定时器始终使用异步调用类型来调用函数,结果不会返回给调用方。有关调用类型的更多信息,请参阅 调用类型。

定时触发器属性

定时器名称(必选):最大支持60个字符,支持 a-zA-Z0-9-_。必须以字母开头,且一个函数下不支持同名的多个定时触发器。触发周期(必选):指定的函数触发时间。用户可以使用控制台上的默认值,或选择自定义标准的 Cron 表达式来决定何时触发函数。有关 Cron 表达式的更多信息,请参考下面的内容。入参(可选):最大支持4KB的字符串,可以在入口函数的 “event” 参数中获取。

Cron 表达式

定时触发器现已推出秒级触发功能,创建定时触发器时,用户能够使用标准的 Cron 表达式的形式自定义何时触发。

Cron 表达式语法

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

第一位 第二位 第三位 第四位 第五位 第六位 第七位
分钟 小时 星期

其中,每个字段都有相应的取值范围:

字段 通配符 特殊符号
0 – 59的整数 , – * /
分钟 0 – 59的整数 , – * /
小时 0 – 23的整数 , – * /
1 – 31的整数(需要考虑月的天数) , – * / ? L W
1 – 12的整数或 JAN,FEB,MAR,APR,MAY,JUN,JUL,AUG,SEP,OCT,NOV,DEC , – * /
星期 0 – 6的整数或 SUN,MON,TUE,WED,THU,FRI,SAT。其中0指星期日,1指星期一,以此类推。 , – * / ? L #
1970 – 2099的整数 , – * /

通配符

通配符 含义
,(逗号) 代表取用逗号隔开的字符的并集。例如:在“小时”字段中 1,2,3 表示1点、2点和3点。
-(破折号) 包含指定范围的所有值。例如:在“日”字段中,1 – 15包含指定月份的1号到15号。
*(星号) 表示所有值。在“小时”字段中,* 表示每个小时。
/(正斜杠) 指定增量。在“分钟”字段中,输入1/10以指定从第一分钟开始的每隔十分钟重复。例如,第11分钟、第21分钟和第31分钟,以此类推。

特殊符号

特殊符号 含义
? 只可使用在“日”字段、“星期”字段,表示不指定具体某日或星期几。例如:“日”字段指定为2,“星期”字段为“?”时,表示只判断日期为2日,而不指定2日为星期几。
L 只可使用在“日”字段、“星期”字段,表示“最后”。在“日”字段,表示月份的最后一天;在“星期”字段,表示最后一个星期几,限定范围为0-6的整数,例如:5L 表示最后一个星期五。
W 只可使用在“日”字段,表示距离某日最接近的工作日(星期一到星期五)。例如:10W 表示离10日最接近的工作日,配合“月”字段,可表示 某月中最接近某日的工作日;“日”字段中,“L”与“W”组合为“LW”使用时表示月份的最后一个工作日。
# 只可使用在“星期”字段,且“#”前后必须给定数字,表示第几个星期几。“#”前的数字表示星期几,范围为0-6的整数;“#”后的数字表示第几个,范围为1-5的整数。例如:2#3 表示第三个星期二。

注意事项

1. 在 Cron 表达式中的“日”和“星期”字段同时指定具体值时,两者为“或”关系,即两者的条件分别均生效。2. 使用“W”符号时,指定某日与其最近的工作日为同一月,不会跨月。如指定“1W”,即距离1日最接近的工作日,当1日为周六时,与1日最接近的工作日为本月3日(周一),而不是上月最后一日(周五)。

示例

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

表达式 相关含义
*/5 * * * * * * 表示每5秒触发一次
0 15 10 1 * ? * 表示在每月的1日的上午10:15触发
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点触发
0 0 0 L * * * 表示在每月的最后一天的零时触发
0 0 0 * 5 4L * 表示在5月的最后一个周四的零时触发
0 0 0 12W 6 * * 表示在6月中最接近12日的工作日的零时触发
0 0 0 ? * 2#3 * 表示在每月的第三个星期二的零时触发
0 0 0 LW * ? * 表示在每月的最后一个工作日的零时触发

定时触发器入参说明

定时触发器在触发函数时,会把如下的数据结构封装在 event 里传给云函数。同时,定时触发器支持自定义传入 Message,缺省为空。

{    "Type":"Timer",    "TriggerName":"EveryDay",    "Time":"2019-02-21T11:49:00Z",    "Message":"user define msg body"}
字段 含义
Type 触发器的类型,值为 Timer。
TriggerName 定时触发器的名称。最大支持60个字符,支持 a-zA-Z0-9-_。必须以字母开头,且一个函数下不支持同名的多个定时触发器。
Time 触发器创建时间,0时区。
Message 字符串类型。



官网1折活动,限时活动,即将结束,速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠

转转请注明出处:https://www.yunxiaoer.com/149539.html

(0)
上一篇 2023年12月9日 下午1:21
下一篇 2023年12月9日 下午1:21
详情页2

相关推荐

  • 腾讯云云函数(SCF)联系我们-云淘科技

    售前咨询 当您需要购买咨询时,您可以直接通过 售前咨询 进行提问,会有专属客户经理在线为您解答,为您提供专业的上云方案。同时,您也可以直接致电销售人员,咨询热线:4009100100转1(工作日9:00 – 18:00)。 售后支持 当您遇到问题需要处理时,您可以直接通过 售后支持 进行提问,腾讯云工程师7 × 24小时在线为您提供服务。同时,您…

    2023年12月9日
  • 腾讯云云函数(SCF)词汇表-云淘科技

     官网1折活动,限时活动,即将结束,速速收藏同尘科技为腾讯云授权服务中心。购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠

    腾讯云 2023年12月9日
  • 腾讯云云函数(SCF)示例说明-云淘科技

    本教程假设以下情况:您将不定时上传一些文本文件(例如日志等)至某个特定的 COS Bucket。您要对这些文本文件进行字数统计。 实现概要 下面是该函数的实现流程:创建函数与 COS Bucket。用户将对象上传到 COS 中的源存储桶(对象创建事件)。COS Bucket 检测到对象创建事件。COS 调用函数并将事件数据作为参数传递给函数,由此将 cos:…

    腾讯云 2023年12月9日
  • 信息流广告,信息流部分建议宽度830px,只针对默认列表样式,顺序随机
  • 腾讯云云函数(SCF)步骤 1. 准备 COS Bucket-云淘科技

    请确保您在执行此示例时,已经获得了 SCF 使用权限。1. 登录腾讯云控制台,选择云产品 > 存储 > 对象存储服务。2. 选择左侧导航栏中的 存储桶列表,进入“存储桶列表”页面。3. 在“存储桶列表”页面,单击创建存储桶。4. 在弹出的“创建存储桶”窗口中,参考以下信息新建源 COS Bucket。n 设置 COS Bucket 的名称例如 s…

    腾讯云 2023年12月9日
  • 腾讯云云函数(SCF)触发器概述-云淘科技

    腾讯云云函数目前支持事件触发与 HTTP 请求触发两种触发模式: 事件触发 事件触发(Event-Triggered)是典型的无服务器运行方式,核心组件是 SCF 函数和事件源。其中,事件源是发布事件(Event)的腾讯云服务或用户自定义代码,SCF 函数是事件的处理者,而函数触发器就是管理函数和事件源对应关系的集合。例如以下场景:图像/视频处理:用户上传图…

    腾讯云 2023年12月9日

联系我们

400-800-8888

在线咨询: QQ交谈

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

关注微信
本站为广大会员提供阿里云、腾讯云、华为云、百度云等一线大厂的购买,续费优惠,保证底价,买贵退差。