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
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.8.3

Feb 12, 2026

v1.8.1

Jan 13, 2026

v1.8.0

Dec 5, 2025

v1.7.3

Nov 28, 2025

v1.7.2

Nov 11, 2025

v1.7.1

Oct 18, 2025

v1.7.0

Oct 12, 2025

v1.6.1

Sep 10, 2025

v1.6.0

Sep 10, 2025

v1.5.3

Jul 28, 2025

Changes in this version

type Metrics

+ ObserveDuration func(name string, durationSeconds float64)

v1.5.2

Jul 28, 2025

v1.5.1

Jul 28, 2025

Changes in this version

+ type Options struct

+ EnableMetrics bool

+ Name string

+ ParallelSkip bool

+ Timeout libtime.Duration

+ func DefaultOptions() Options

v1.5.0

Jul 28, 2025

Changes in this version

+ func NewExpressionCronWithOptions(expression Expression, action run.Runnable, options CronJobOptions) run.Runnable

+ func NewIntervalCronWithOptions(wait time.Duration, action run.Runnable, options CronJobOptions) run.Runnable

+ func NewOneTimeCronWithOptions(action run.Runnable, options CronJobOptions) run.Runnable

+ func WrapWithOptions(action run.Runnable, options CronJobOptions) run.Runnable

v1.4.0

Jul 28, 2025

Changes in this version

+ func WrapWithMetrics(name string, fn run.Runnable) run.Runnable

+ func WrapWithTimeout(name string, timeout time.Duration, fn run.Runnable) run.Runnable

type CronJob

+ func NewCronJobWithOptions(oneTime bool, expression Expression, wait time.Duration, action run.Runnable, ...) CronJob

+ type CronJobOptions struct

+ EnableMetrics bool

+ Name string

+ ParallelSkip bool

+ Timeout time.Duration

+ func DefaultCronJobOptions() CronJobOptions

+ type Metrics interface

+ IncreaseCompleted func(name string)

+ IncreaseFailed func(name string)

+ IncreaseStarted func(name string)

+ SetLastSuccessToCurrent func(name string)

+ func NewMetrics() Metrics

v1.3.1

Jul 22, 2025

Changes in this version

type CronJob

+ func NewIntervalCron(wait time.Duration, action run.Runnable) CronJob

v1.3.0

Mar 30, 2025

v1.2.4

Mar 19, 2025

v1.2.3

Feb 4, 2025

v1.2.2

Dec 25, 2024

v1.2.1

Dec 24, 2024

v1.2.0

Nov 3, 2024

Changes in this version

+ func CreateDefaultParser() cron.Parser

+ type Expression string

+ func (e Expression) Bytes() []byte

+ func (e Expression) Ptr() *Expression

+ func (e Expression) String() string

v1.1.0

Apr 17, 2024

v1.0.1

Apr 17, 2024

v1.0.0

Mar 26, 2024

Changes in this version

+ type Cron interface

+ Run func(ctx context.Context) error

+ type CronJob interface

+ Run func(ctx context.Context) error

+ func NewCronJob(oneTime bool, expression string, wait time.Duration, ...) CronJob

+ func NewExpressionCron(ext string, action action) CronJob

+ func NewOneTimeCron(action action) CronJob

+ func NewWaitCron(wait time.Duration, action action) CronJob