摘自：https://www.topgoer.com/%E9%A1%B9%E7%9B%AE/%E5%AE%9A%E6%97%B6%E4%BB%BB%E5%8A%A1/cron.html

1. cron

1.1.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)字段如果没提供，相当于是 *

1.1.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)，\表示不指定值，可以用于代替

1.1.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 ?

    1.1.4. 示例

    最简单crontab任务
    根据官网手册写法 ```go package main

import ( “github.com/robfig/cron” “log” )

func main() { i := 0 c := cron.New() spec := “/5 * ?” _,err:=c.AddFunc(spec, func() { i++ log.Println(“cron running:”, i) }) fmt.Println(err) c.Start()

  1. select{}

}

  1. 会报一个错误
  2. ```go
  3. expected exactly 5 fields, found 6: [*/5 * * * * ?]

这就尴尬了，查询大量资料，把代码修改为一下代码就可以完美运行了

  1. package main
  3. import (
  4.     "fmt"
  6.     "github.com/robfig/cron"
  7. )
  9. // 返回一个支持至 秒 级别的 cron
  10. func newWithSeconds() *cron.Cron {
  11.     secondParser := cron.NewParser(cron.Second | cron.Minute |
  12.                                    cron.Hour | cron.Dom | cron.Month | cron.DowOptional | cron.Descriptor)
  13.     return cron.New(cron.WithParser(secondParser), cron.WithChain())
  14. }
  15. func main() {
  16.     i := 0
  17.     c := newWithSeconds()
  18.     spec := "0 */1 * * * ?"  //一分钟运行一次
  19.     c.AddFunc(spec, func() {
  20.         i++
  21.         fmt.Println("cron running:", i)
  22.     })
  23.     c.Start()
  25.     select {}
  26. }

输出结果：

  1. cron running: 1
  2. cron running: 2
  3. cron running: 3

多个定时crontab任务

  1. package main
  3. import (
  4.     "fmt"
  5.     "log"
  7.     "github.com/robfig/cron"
  8. )
  10. type TestJob struct {
  11. }
  13. func (this TestJob) Run() {
  14.     fmt.Println("testJob1...")
  15. }
  17. type Test2Job struct {
  18. }
  20. func (this Test2Job) Run() {
  21.     fmt.Println("testJob2...")
  22. }
  24. // 返回一个支持至 秒 级别的 cron
  25. func newWithSeconds() *cron.Cron {
  26.     secondParser := cron.NewParser(cron.Second | cron.Minute |
  27.                                    cron.Hour | cron.Dom | cron.Month | cron.DowOptional | cron.Descriptor)
  28.     return cron.New(cron.WithParser(secondParser), cron.WithChain())
  29. }
  30. func main() {
  31.     i := 0
  32.     c := newWithSeconds()
  33.     //AddFunc
  34.     spec := "*/5 * * * * ?"
  35.     c.AddFunc(spec, func() {
  36.         i++
  37.         log.Println("cron running:", i)
  38.     })
  40.     //AddJob方法
  41.     c.AddJob(spec, TestJob{})
  42.     c.AddJob(spec, Test2Job{})
  44.     //启动计划任务
  45.     c.Start()
  47.     //关闭着计划任务, 但是不能关闭已经在执行中的任务.
  48.     defer c.Stop()
  50.     select {}
  51. }

输出结果：

  1. 2019/11/14 17:23:10 cron running: 1
  2. testJob2...
  3. testJob1...
  4. 2019/11/14 17:23:15 cron running: 2
  5. testJob2...
  6. testJob1...

1. gocron

1.1.1. jasonlvhit/gocron

安装：

  1. go get -u github.com/jasonlvhit/gocron

每隔1秒执行一个任务，每隔4秒执行另一个任务：

  1. package main
  3. import (
  4.     "fmt"
  5.     "time"
  7.     "github.com/jasonlvhit/gocron"
  8. )
  10. func task() {
  11.     fmt.Println("I am runnning task.", time.Now())
  12. }
  13. func superWang() {
  14.     fmt.Println("I am runnning superWang.", time.Now())
  15. }
  17. func main() {
  18.     s := gocron.NewScheduler()
  19.     s.Every(1).Seconds().Do(task)
  20.     s.Every(4).Seconds().Do(superWang)
  22.     sc := s.Start() // keep the channel
  23.     go test(s, sc)  // wait
  24.     <-sc            // it will happens if the channel is closed
  25. }
  27. func test(s *gocron.Scheduler, sc chan bool) {
  28.     time.Sleep(8 * time.Second)
  29.     s.Remove(task) //remove task
  30.     time.Sleep(8 * time.Second)
  31.     s.Clear()
  32.     fmt.Println("All task removed")
  33.     close(sc) // close the channel
  34. }

输出结果：

  1. I am runnning task. 2019-11-15 09:37:07.218128145 +0800 CST m=+1.000414542
  2. I am runnning task. 2019-11-15 09:37:08.218062127 +0800 CST m=+2.000348513
  3. I am runnning task. 2019-11-15 09:37:09.218047138 +0800 CST m=+3.000333512
  4. I am runnning superWang. 2019-11-15 09:37:10.218058701 +0800 CST m=+4.000345070
  5. I am runnning task. 2019-11-15 09:37:10.218100706 +0800 CST m=+4.000387079
  6. I am runnning task. 2019-11-15 09:37:11.218033085 +0800 CST m=+5.000319455
  7. I am runnning task. 2019-11-15 09:37:12.21804561 +0800 CST m=+6.000331978
  8. I am runnning task. 2019-11-15 09:37:13.218053083 +0800 CST m=+7.000339456
  9. I am runnning superWang. 2019-11-15 09:37:14.218038711 +0800 CST m=+8.000325086
  10. I am runnning superWang. 2019-11-15 09:37:18.218061128 +0800 CST m=+12.000347516
  11. I am runnning superWang. 2019-11-15 09:37:22.218054256 +0800 CST m=+16.000340629
  12. All task removed