gcron

gcron模块提供了对定时任务的实现，支持类似crontab的配置管理方式，并支持最小粒度到秒的定时任务管理。

使用方式：

  1. import "gitee.com/johng/gf/g/os/gcron"

方法列表：godoc.org/github.com/johng-cn/gf/g/os/gcron

  1. func Add(spec string, f func(), name...string) error
  2. func Remove(name string)
  3. func Search(name string) *Entry
  4. func Entries() []Entry

简要说明：

  1. Add方法用于添加定时任务，其中：
    • spec 参数使用CRON语法格式(具体说明见本章后续相关说明)；
    • f 参数为需要执行的任务方法(方法地址)；
    • name 为非必需参数，用于给定时任务指定一个唯一的名称，注意如果已存在相同名称的任务，那么添加定时任务将会失败；
  2. Remove方法用于根据名称删除定时任务；
  3. Entries方法用于获取当前所有已注册的定时任务信息；
  4. Search方法用于根据名称进行定时任务搜索；

使用示例

  1. package main
  3. import (
  4.     "fmt"
  5.     "gitee.com/johng/gf/g"
  6.     "gitee.com/johng/gf/g/os/gcron"
  7.     "time"
  8. )
  10. func main() {
  11.     gcron.Add("0 30 * * * *", func() { fmt.Println("Every hour on the half hour") })
  12.     gcron.Add("* * * * * *",  func() { fmt.Println("Every second") }, "second-cron")
  13.     gcron.Add("@hourly",      func() { fmt.Println("Every hour") })
  14.     gcron.Add("@every 1h30m", func() { fmt.Println("Every hour thirty") })
  15.     g.Dump(gcron.Entries())
  17.     time.Sleep(3*time.Second)
  19.     gcron.Remove("second-cron")
  21.     time.Sleep(3*time.Second)
  22. }

CRON表达格式

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

  1. Field name   | Mandatory? | Allowed values  | Allowed special characters
  2. ----------   | ---------- | --------------  | --------------------------
  3. Seconds      | Yes        | 0-59            | * / , -
  4. Minutes      | Yes        | 0-59            | * / , -
  5. Hours        | Yes        | 0-23            | * / , -
  6. Day          | Yes        | 1-31            | * / , - ?
  7. Month        | Yes        | 1-12 or JAN-DEC | * / , -
  8. Week         | Yes        | 0-6 or SUN-SAT  | * / , - ?

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

特殊字符

星号（*）

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

斜线（/）

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

逗号（,）

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

连字符（-）

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

问号（?）

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

预定义的时间表

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

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

间隔

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

  1. @every <duration>

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

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

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