Seconds Minutes Hours DayofMonth Month DayofWeek

type Cron struct {  
   entries  []*Entry  
   stop     chan struct{}   // 控制 Cron 实例暂停  
   add      chan *Entry     // 当 Cron 已经运行了，增加新的 Entity 是通过 add 这个channel 实现的  
   snapshot chan []*Entry   // 获取当前所有 entity 的快照  
   running  bool            // 当已经运行时为true；否则为false  
}  

type Entry struct {  
   // The schedule on which this job should be run.  
   // 负责调度当前 Entity 中的 Job 执行  
   Schedule Schedule  
   
   // The next time the job will run. This is the zero time if Cron has notbeen  
   // started or this entry's schedule is unsatisfiable  
   // Job 下一次执行的时间  
   Next time.Time  
   
   // The last time this job was run. This is the zero time if the job hasnever  
   // been run.  
   // 上一次执行时间  
   Prev time.Time  
   
   // The Job to run.  
   // 要执行的 Job  
   Job Job  
}  

type job interface {
    Run()
}

type Schedule interface {  
   // Return the next activation time, later than the given time.  
   // Next is invoked initially, and then each time the job is run.  
   // 返回同一 Entity 中的 Job 下一次执行的时间  
   Next(time.Time) time.Time  
}  

type SpecSchedule struct {  
   Second, Minute, Hour, Dom, Month, Dow uint64  
}  

type ConstantDelaySchedule struct {  
   Delay time.Duration // 循环的时间间隔  
}  

func New() *Cron {
   return &Cron{
       entries:  nil,
       add:      make(chan *Entry),
       stop:     make(chan struct{}),
       snapshot: make(chan []*Entry),
       running:  false,
    }
}

func Parse(spec string) (_ Schedule, errerror)

// spec 可以是：

// Full crontab specs, e.g. “* * * * * ?”

// Descriptors, e.g. “@midnight”, “@every1h30m”

// 将 job加入 Cron中
// 如上所述，该方法只是简单的通过FuncJob类型强制转换 cmd，然后调用 AddJob方法
func (c *Cron) AddFunc(spec string, cmdfunc()) error


// 将 job加入 Cron中
// 通过 Parse函数解析 cron表达式 spec的到调度器实例(Schedule)，之后调用 c.Schedule方法
func (c *Cron) AddJob(spec string, cmd Job)error


// 获取当前 Cron总所有 Entities的快照
func (c *Cron) Entries() []*Entry


// 通过两个参数实例化一个Entity，然后加入当前 Cron 中
// 注意：如果当前 Cron未运行，则直接将该 entity加入 Cron中；
// 否则，通过 add这个成员 channel将 entity加入正在运行的 Cron中
func (c *Cron) Schedule(schedule Schedule,cmd Job)

 
// 新启动一个 goroutine运行当前 Cron
func (c *Cron) Start()

 
// 通过给 stop成员发送一个 struct{}{}来停止当前 Cron，同时将 running置为 false
// 从这里知道，stop只是通知 Cron停止，因此往 channel发一个值即可，而不关心值是多少
// 所以，成员 stop定义为空 struct
func (c *Cron) Stop()

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{}
}