Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

cron

package module

Go to main page

Versions in this module

v1

v1.2.0

May 5, 2018

v1.1.0

May 5, 2018

Changes in this version

type Cron

+ ErrorLog *log.Logger

+ func NewWithLocation(location *time.Location) *Cron

v1.0.0

Jan 19, 2014

Changes in this version

type Schedule

+ func Parse(spec string) (_ Schedule, err error)

v0

v0.2.2

Oct 16, 2019

v0.2.1

Oct 16, 2019

Changes in this version

type Cron

+ func DelayNew(start int64, end int64, opts ...Option) (*Cron, error)

v0.2.0

Oct 16, 2019

v0.1.2

Oct 16, 2019

Changes in this version

+ type Chain struct

+ func NewChain(c ...JobWrapper) Chain

+ func (c Chain) Then(j Job) Job

+ type ConstantDelaySchedule struct

+ Delay time.Duration

+ func Every(duration time.Duration) ConstantDelaySchedule

+ func (schedule ConstantDelaySchedule) Next(t time.Time) time.Time

+ type Cron struct

+ func New(opts ...Option) *Cron

+ func (c *Cron) AddFunc(spec string, cmd func()) (EntryID, error)

+ func (c *Cron) AddJob(spec string, cmd Job) (EntryID, error)

+ func (c *Cron) DelayStart(start int64)

+ func (c *Cron) DelayStop(end int64) error

+ func (c *Cron) Entries() []Entry

+ func (c *Cron) Entry(id EntryID) Entry

+ func (c *Cron) Location() *time.Location

+ func (c *Cron) Remove(id EntryID)

+ func (c *Cron) Run()

+ func (c *Cron) Schedule(schedule Schedule, cmd Job) EntryID

+ func (c *Cron) Start()

+ func (c *Cron) Stop() context.Context

+ type Entry struct

+ ID EntryID

+ Job Job

+ Next time.Time

+ Prev time.Time

+ Schedule Schedule

+ WrappedJob Job

+ func (e Entry) Valid() bool

+ type EntryID int

+ type FuncJob func()

+ func (f FuncJob) Run()

+ type Job interface

+ Run func()

+ type JobWrapper func(Job) Job

+ func DelayIfStillRunning(logger Logger) JobWrapper

+ func Recover(logger Logger) JobWrapper

+ func SkipIfStillRunning(logger Logger) JobWrapper

+ type Logger interface

+ Error func(err error, msg string, keysAndValues ...interface{})

+ Info func(msg string, keysAndValues ...interface{})

+ var DefaultLogger Logger = PrintfLogger(log.New(os.Stdout, "cron: ", log.LstdFlags))

+ var DiscardLogger Logger = PrintfLogger(log.New(ioutil.Discard, "", 0))

+ func PrintfLogger(l interface{ ... }) Logger

+ func VerbosePrintfLogger(l interface{ ... }) Logger

+ type Option func(*Cron)

+ func WithChain(wrappers ...JobWrapper) Option

+ func WithLocation(loc *time.Location) Option

+ func WithLogger(logger Logger) Option

+ func WithParser(p Parser) Option

+ func WithSeconds() Option

+ type ParseOption int

+ const Descriptor

+ const Dom

+ const Dow

+ const DowOptional

+ const Hour

+ const Minute

+ const Month

+ const Second

+ const SecondOptional

+ type Parser struct

+ func NewParser(options ParseOption) Parser

+ func (p Parser) Parse(spec string) (Schedule, error)

+ type Schedule interface

+ Next func(time.Time) time.Time

+ func ParseStandard(standardSpec string) (Schedule, error)

+ type SpecSchedule struct

+ Dom uint64

+ Dow uint64

+ Hour uint64

+ Location *time.Location

+ Minute uint64

+ Month uint64

+ Second uint64

+ func (s *SpecSchedule) Next(t time.Time) time.Time