1、cron 表達式的基本格式
用過 linux 的應該對 cron 有所了解。linux 中可以通過 crontab -e 來配置定時任務。不過,linux 中的 cron 只能精確到分鍾。而我們這里要討論的 Go 實現的 cron 可以精確到秒,除了這點比較大的區別外,cron 表達式的基本語法是類似的。(如果使用過 Java 中的 Quartz,對 cron 表達式應該比較了解,而且它和這里我們將要討論的 Go 版 cron 很像,也都精確到秒) cron(計划任務),顧名思義,按照約定的時間,定時的執行特定的任務(job)。cron 表達式 表達了這種約定。 cron 表達式代表了一個時間集合,使用 6 個空格分隔的字段表示。
字段名 | 是否必須 | 允許的值 | 允許的特定字符 |
秒(Seconds) | 是 | 0-59 | * / , - |
分(Minutes) | 是 | 0-59 | * / , - |
時(Hours) | 是 | 0-23 | * / , - |
日(Day of month) | 是 | 1-31 | * / , – ? |
月(Month) | 是 | 1-12 or JAN-DEC | * / , - |
星期(Day of week) | 否 | 0-6 or SUM-SAT | * / , – ? |
注:
1)月(Month)和星期(Day of week)字段的值不區分大小寫,如:SUN、Sun 和 sun 是一樣的。 2)星期 (Day of week)字段如果沒提供,相當於是 *
2、特殊字符說明
1)星號(*) 表示 cron 表達式能匹配該字段的所有值。如在第5個字段使用星號(month),表示每個月 2)斜線(/) 表示增長間隔,如第1個字段(minutes) 值是 3-59/15,表示每小時的第3分鍾開始執行一次,之后每隔 15 分鍾執行一次(即 3、18、33、48 這些時間點執行),這里也可以表示為:3/15 3)逗號(,) 用於枚舉值,如第6個字段值是 MON,WED,FRI,表示 星期一、三、五 執行 4)連字號(-) 表示一個范圍,如第3個字段的值為 9-17 表示 9am 到 5pm 直接每個小時(包括9和17) 5)問號(?) 只用於日(Day of month)和星期(Day of week),\表示不指定值,可以用於代替 *
3、cron舉例說明
每隔5秒執行一次:*/5 * * * * ?
每隔1分鍾執行一次:0 */1 * * * ?
每天23點執行一次:0 0 23 * * ?
每天凌晨1點執行一次:0 0 1 * * ?
每月1號凌晨1點執行一次:0 0 1 1 * ?
在26分、29分、33分執行一次:0 26,29,33 * * * ?
每天的0點、13點、18點、21點都執行一次:0 0 0,13,18,21 * * ?
4、示例
- 最簡單crontab任務
package main import ( "github.com/robfig/cron" "log" ) func main() { i := 0 c := cron.New() spec := "*/5 * * * * ?" c.AddFunc(spec, func() { i++ log.Println("cron running:", i) }) c.Start() select{} }
啟動后輸出如下:
cron running : 1 cron running : 2 cron running : 3 cron running : 4 cron running : 5 ...
- 多個定時crontab任務
package main import ( "github.com/robfig/cron" "log" "fmt" ) type TestJob struct { } func (this TestJob)Run() { fmt.Println("testJob1...") } type Test2Job struct { } func (this Test2Job)Run() { fmt.Println("testJob2...") } //啟動多個任務 func main() { i := 0 c := cron.New() //AddFunc spec := "*/5 * * * * ?" c.AddFunc(spec, func() { i++ log.Println("cron running:", i) }) //AddJob方法 c.AddJob(spec, TestJob{}) c.AddJob(spec, Test2Job{}) //啟動計划任務 c.Start() //關閉着計划任務, 但是不能關閉已經在執行中的任務. defer c.Stop() select{} }
go run crontab/crontab-2.go 啟動后輸出如下: testJob1... 2017/07/07 18:46:40 cron running: 1 testJob2... 2017/07/07 18:46:45 cron running: 2 testJob1... testJob2... 2017/07/07 18:46:50 cron running: 3 testJob1... testJob2... 2017/07/07 18:46:55 cron running: 4 testJob1... testJob2... testJob2... testJob1... 2017/07/07 18:47:00 cron running: 5 ...