# 定时任务

低代码平台支持用户自定义服务端定时任务,通过可视化设置Cron表达式,约定任务自动执行时间和间隔。

# 操作步骤

  1. 选择一个需要定时执行的逻辑,右键”设置定时任务“。

image-20220126095259446

  1. 在弹出窗口中填写定时任务的规则表达式

规则表达式常用说明见界面,完整说明参考后续Cron规则说明。

小技巧:可以通过左下角“导入规则模板”,选择一个较为相似的场景模板,稍加修改即可使用。

注意!!请谨慎使用秒级触发的定时任务,可能会影响应用性能。

image-20220126095402765

image-20220126100044603

3、表达式设置完成后,右侧会出现模拟最近10次运行时间,可以确认表达式设置是否准确。

image-20220126100455290

4、当表达式出现问题时,会提示错误信息,请根据Cron规则检查表达式。

image-20220126100546651image-20220126100607376

5、点击右下角“保存”,则可以保存表达式设置,但此时定时任务并未生效,需要发布后才能生效。

image-20220126100728121

6、已设置定时任务的逻辑,会出现小图标。

image-20220126100817415

7、右键该逻辑,可以取消定时任务,同样也是发布后生效。

image-20220126100858984image-20220126100911308

# 完整的Cron表达式规则

Cron表达式是一个字符串,是由空格隔开的6或7个域组成,每一个域对应一个含义(*秒 分 时 每月第几天 月 星期 年)*其中年是可选字段,低代码平台中暂时不支持年的设置。

# 各域支持的字符类型

秒:可出现", - * /"四个字符,有效范围为0-59的整数

分:可出现", - * /"四个字符,有效范围为0-59的整数

时:可出现", - * /"四个字符,有效范围为0-23的整数

每月第几天:可出现", - * / ? L W C"八个字符,有效范围为0-31的整数

月:可出现", - * /"四个字符,有效范围为1-12的整数或JAN-DEC

星期:可出现", - * / ? L C #"四个字符,有效范围为1-7的整数或SUN-SAT两个范围。1表示星期天,2表示星期一, 依次类推

# 特殊字符含义

* : 表示匹配该域的任意值,比如在秒*, 就表示每秒都会触发事件。

? : 只能用在每月第几天和星期两个域。表示不指定值,当2个子表达式其中之一被指定了值以后,为了避免冲突,需要将另一个子表达式的值设为“?”

- : 表示范围,例如在分域使用5-20,表示从5分到20分钟每分钟触发一次

/ : 表示起始时间开始触发,然后每隔固定时间触发一次,例如在分域使用5/20,则意味着5分,25分,45分,分别触发一次

, : 表示列出枚举值。例如:在分域使用5,20,则意味着在5和20分时触发一次

L : 表示最后,只能出现在星期和每月第几天域,如果在星期域使用1L,意味着在最后的一个星期日触发

W : 表示有效工作日(周一到周五),只能出现在每月第几日域,系统将在离指定日期的最近的有效工作日触发事件。注意一点,W的最近寻找不会跨过月份

LW : 这两个字符可以连用,表示在某个月最后一个工作日,即最后一个星期五

# : 用于确定每个月第几个星期几,只能出现在“星期”域。例如在1#3,表示某月的第三个星期日

上次更新: 2023年06月14日