gcron
使用方式:
方法列表:godoc.org/github.com/johng-cn/gf/g/os/gcron
func Add(spec string, f func(), name...string) error
func Remove(name string)
func Search(name string) *Entry
func Entries() []Entry
简要说明:
Add
方法用于添加定时任务,其中:spec
参数使用CRON语法格式
(具体说明见本章后续相关说明);f
参数为需要执行的任务方法(方法地址);- 为非必需参数,用于给定时任务指定一个唯一的名称,注意如果已存在相同名称的任务,那么添加定时任务将会失败;
Remove
方法用于根据名称删除定时任务;Search
方法用于根据名称进行定时任务搜索;
CRON表达格式
cron表达式
表示一组时间,使用6
个空格分隔的字段。
Field name | Mandatory? | Allowed values | Allowed special characters
---------- | ---------- | -------------- | --------------------------
Seconds | Yes | 0-59 | * / , -
Minutes | Yes | 0-59 | * / , -
Hours | Yes | 0-23 | * / , -
Day | Yes | 1-31 | * / , - ?
Month | Yes | 1-12 or JAN-DEC | * / , -
Week | Yes | 0-6 or SUN-SAT | * / , - ?
星号(*
)
星号表示cron表达式将匹配所有的值。例如,在第五个字段(Month
)中使用星号表示每个月。
斜线()
斜杠用于描述范围的增量。例如:第二个字段使用3-59/15
表示每小时的第3分钟开始到第59分钟,每隔15分钟执行。
逗号(,
)
逗号用于分隔列表的项目。例如,第五个字段使用MON,WED,FRI
将指每周一,周三和周五执行。
连字符(-
)
连字符用于定义范围。例如,第三个字段使用9-17
表示每天上午9点至下午5点(含)。
问号(?
)
预定义的时间表
您可以使用几个预定义的时间来代替cron表达式。
间隔
您还可以定义任务以固定的时间间隔执行,从添加时开始运行。这可以通过格式化cron规范来支持,如下所示:
其中duration
是time.ParseDuration
接受的字符串
()。
例如,@every 1h30m10s
将表示添加任务之后每隔1小时30分10秒
执行。