Golang使用cron调度定时任务

本文介绍如何使用cron v3在一定时间间隔调度job任务执行。采用cron运行后端进程非常有用，如定期从第三方服务器拉去数据、两个服务器间同步数据、在一定时间间隔时发送通知邮件等。

介绍Cron v3

cron v3是非常流行的包，它实现了cron规范，包括解析器和执行器。我们利用它调度任务在特定时间间隔执行。

运行下面命令下载包：

go get github.com/robfig/cron/v3@v3.0.0

使用需在程序导入包：

import "github.com/robfig/cron/v3"

因为使用Go Modules，需要Go 1.11以上版本。v3版本是最新版本，修复之前版本的大量bug。

cron表达式

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

注意：月份和星期字段值是不区分大小写的，“SUN”, “Sun”, 和 “sun” 三者等效。

星号(*) : 星号表示匹配该字段所有值，举例：第五个字段（月份）表示每个月

斜杠（/）：描述增加范围。举例第一个字段(分钟）值为:3-59/15,表示第三分钟之后，每十五分钟执行一次。

逗号（,）：逗号用于分隔多个值项。例如，在第5个字段(星期)中使用“MON,WED,FRI”表示星期一、星期三和星期五。

连字符(-)：连字符用于定义范围。例如，9-17表示上午9点到下午5点之间的每小时。

问号(?)：问号可以用来代替“*”，以便将月中的哪一天或星期中的哪一天空出来。

预定义表达式

处理cron表达式，cron-v3还预定义了一些快捷调度表达式：

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 * * * *

示例

c := cron.New()
c.AddFunc("0 30 * * * *", func() { fmt.Println("Every hour on the half hour") })
c.AddFunc("@hourly",      func() { fmt.Println("Every hour") })
c.AddFunc("@every 1h30m", func() { fmt.Println("Every hour thirty") })
c.Start()
..
// Funcs are invoked in their own goroutine, asynchronously.
...
// Funcs may also be added to a running Cron
c.AddFunc("@daily", func() { fmt.Println("Every day") })
..
// Inspect the cron job entries' next and previous run times.
inspect(c.Entries())
..
c.Stop()  // Stop the scheduler (does not stop any jobs already running).

完整实例

package main

import (
	"fmt"
	"github.com/robfig/cron/v3"
)

func main() {
	c := cron.New()、
    // 在协程中异步执行
	c.AddFunc("@every 1s", SendMail)
	c.Start()
	defer c.Stop()

    // 防止程序提前结束
	var ch = make(chan int)
	<-ch
}

func SendMail() {
	fmt.Println("Successfully! Mail has been sent!.")
}

执行程序，每秒输出输出一次"Successfully! Mail has been sent!."

更多信息参考官方文档：https://pkg.go.dev/github.com/robfig/cron#hdr-Usage。