cron表达式基本含义
| 字段名 |
是否必须 |
允许的值 |
允许的特定字符 |
| 秒(Seconds) |
是 |
0-59 |
* / , - |
| 分(Minute) |
是 |
0-59 |
* / , - |
| 时(Hours) |
是 |
0-23 |
* / , - |
| 日(Day of month) |
是 |
1-31 |
* / , - ? |
| 月(Month) |
是 |
1-12 或 JAN-DEC |
* / , - |
| 星期(Day of week) |
否 |
0-6 或 SUM-SAT |
* / , - ? |
cron表达式说明
月(Month)和星期(Day of week)字段的值不区分大小写,如:SUN、Sun 和 sun 是一样的。
星期(Day of week)字段如果没提供,相当于是 *
cron表达式示例说明
如果我们使用 crontab := cron.New(cron.WithSeconds()),
比如我们传递了一个字符串是:"* * * * * "在crontab.AddFunc()的第一个参数,这六个是指什么呢?
如果是用crontab := cron.New() 则只需要五个,如 * * * *
┌─────────────second 范围 (0 - 60)
│ ┌───────────── min (0 - 59)
│ │ ┌────────────── hour (0 - 23)
│ │ │ ┌─────────────── day of month (1 - 31)
│ │ │ │ ┌──────────────── month (1 - 12)
│ │ │ │ │ ┌───────────────── day of week (0 - 6) (0 to 6 are Sunday to
│ │ │ │ │ │ Saturday)
│ │ │ │ │ │
│ │ │ │ │ │
* * * * * *
cron特定字符说明
| 符号 |
说明 |
| (*) |
表示 cron 表达式能匹配该字段的所有值。如在第5个字段使用星号(month),表示每个月 |
| (/) |
表示增长间隔,如第1个字段(minutes) 值是 3-59/15,表示每小时的第3分钟开始执行一次,之后每隔 15 分钟执行一次(即 3、18、33、48 这些时间点执行),这里也可以表示为:3/15 |
| (,) |
用于枚举值,如第6个字段值是 MON,WED,FRI,表示 星期一、三、五 执行 |
| (-) |
表示一个范围,如第3个字段的值为 9-17 表示 9am 到 5pm 直接每个小时(包括9和17) |
| (?) |
只用于 日(Day of month) 和 星期(Day of week),表示不指定值,可以用于代替 * |
常用cron举例
每隔5秒执行一次:*/5 * * * * ?
每隔1分钟执行一次:0 */1 * * * ?
每天23点执行一次:0 0 23 * * ?
每天凌晨1点执行一次:0 0 1 * * ?
每月1号凌晨1点执行一次:0 0 1 1 * ?
每周一和周三晚上22:30: 00 30 22 * * 1,3
在26分、29分、33分执行一次:0 26,29,33 * * * ?
每天的0点、13点、18点、21点都执行一次:0 0 0,13,18,21 * * ?
每年三月的星期四的下午14:10和14:40: 00 10,40 14 ? 3 4
预定义的时间格式
| 输入 |
描述 |
等式 |
| @yearly (or @annually) |
每年1月1日午夜跑步一次 |
0 0 0 1 1 * |
| @monthly |
每个月第一天的午夜跑一次 |
0 0 0 1 * * |
| @weekly |
每周周六的午夜运行一次 |
0 0 0 * * 0 |
| @daily (or @midnight) |
每天午夜跑一次 |
0 0 0 * * * |
| @hourly |
每小时运行一次 |
0 0 * * * * |
| @every |
每个时间间隔 |
示例: @every 1h30m |