定时任务设置 #

系统中的涉及到的定时任务采用了类Linux Crontab的表达格式，使得开发者能够快速理解掌握定时任务表达式技巧。但需要注意的是，由于定时任务模块是基于代码层面的控制，因此控制的粒度会更细，最小粒度到秒，格式被划分为了6段。而Linux Crontab是基于程序层面的控制，最小粒度到分，格式被划分为了5段。

在线Cron表达式生成器

Cron表达式校验工具

基本介绍 #

cron表达式表示一组时间，使用6个空格分隔的字段。

Seconds Minutes Hours Day Month Week

即 秒 分 时 日 月 周

每个字段的含义如下：

Field name    | Allowed values  | Allowed special characters
        ----------    | --------------  | --------------------------
        Seconds       | 0-59            | * / , -
        Minutes       | 0-59            | * / , -
        Hours         | 0-23            | * / , -
        Day           | 1-31            | * / , - ?
        Month         | 1-12 or JAN-DEC | * / , -
        Week          | 0-6 or SUN-SAT  | * / , - ?

注意：月份和星期几字段值不区分大小写。 SUN、Sun 和sun同样被接受。

有些子表达式能包含一些范围或列表

例如：子表达式（天（星期））可以为 “MON-FRI”，“MON，WED，FRI”，“MON-WED,SAT”

特殊字符 #

星号（*） #

星号表示cron表达式将匹配所有的值。例如，在第五个字段(Month)中使用星号表示每个月。

因此，“”在子表达式（月）里表示每个月的含义，“”在子表达式（天（星期））表示星期的每一天

斜线（/） #

斜杠用于描述范围的增量。例如：第二个字段使用3-59/15表示每小时的第3分钟开始到第59分钟，每隔15分钟执行。

逗号（,） #

逗号用于分隔列表的项目。例如，第五个字段使用MON,WED,FRI将指每周一，周三和周五执行。

连字符（-） #

连字符用于定义范围。例如，第三个字段使用9-17表示每天上午9点至下午5点（含）。

问号（?） #

可以使用问号而不是*来让Day或Week字段为空。

“？”字符仅被用于天（月）和天（星期）两个子表达式，表示不指定值 　　当2个子表达式其中之一被指定了值以后，为了避免冲突，需要将另一个子表达式的值设为“？”

L字符（L） #

“L” 字符仅被用于天（月）和天（星期）两个子表达式，它是单词“last”的缩写 　　但是它在两个子表达式里的含义是不同的。 　　在天（月）子表达式中，“L”表示一个月的最后一天 　　在天（星期）自表达式中，“L”表示一个星期的最后一天，也就是SAT

如果在“L”前有具体的内容，它就具有其他的含义了

例如：“6L”表示这个月的倒数第６天，“FRIL”表示这个月的最一个星期五 　　注意：在使用“L”参数时，不要指定列表或范围，因为这会导致问题

预定义格式 #

您可以使用几个预定义的时间来代替cron表达式。

Entry                  | Description                                | Equivalent To
        -----                  | -----------                                | -------------
        @yearly (or @annually) | Run once a year, midnight, Jan. 1st        | 0 0 0 1 1 *
        @monthly               | Run once a month, midnight, first of month | 0 0 0 1 * *
        @weekly                | Run once a week, midnight between Sat/Sun  | 0 0 0 * * 0
        @daily (or @midnight)  | Run once a day, midnight                   | 0 0 0 * * *
        @hourly                | Run once an hour, beginning of hour        | 0 0 * * * *

间隔 #

您还可以定义任务以固定的时间间隔执行，从添加时开始运行。这可以通过格式化cron规范来支持，如下所示：

@every
<duration>

其中duration是time.ParseDuration接受的字符串 （http://golang.org/pkg/time/#ParseDuration）。

例如，@every 1h30m10s将表示添加任务之后每隔1小时30分10秒执行。

注意：间隔不会考虑任务的执行时间。例如，如果一项工作需要3分钟才能执行完成，并且计划每隔5分钟运行一次，那么每次任务之间只有2分钟的空闲时间。

表达式示例 #

更多cron表达式例子