Cron 定时任务表达式

Cron 表达式，是应用在 Unix 和类 Unix 操作系统之中，让脚本、任务定时进行周期性重复的执行。Cron 表达式有差丰富的表达能力，能够适应各种时间表达需求。

共 7 位，最后一位可选，可以不写，至少 6 位，从左到右各位置分别是：

位置	意义	取值	支持的符号
1	秒	0-59	, - * /
2	分	0-59	, - * /
3	时	0-23	, - * /
4	日	1-31	, - * ? / L W C
5	月	1-12 或 JAN - DEC	, - * /
6	周	1-7 或 MON - SAT	, - * ? / L C #
7	年	空或 1970-2099	, - * /

注：Cron 表达式对日期英文缩写、特殊字符大小写不敏感。

秒

允许值范围: 0~59 ,不允许为空值，若值不合法，调度器将抛出SchedulerException异常

“*” 代表每隔1秒钟触发

“,” 代表在指定的秒数触发，比如”0,15,45”代表0秒、15秒和45秒时触发任务

“-“ 代表在指定的范围内触发，比如”25-45”代表从25秒开始触发到45秒结束触发，每隔1秒触发1次

“/“ 代表触发步进(step)，”/“前面的值代表初始值(““等同”0”)，后面的值代表偏移量，比如”0/20”或者”/20”代表从0秒钟开始，每隔20秒钟触发1次，即0秒触发1次，20秒触发1次，40秒触发1次；”5/20”代表5秒触发1次，25秒触发1次，45秒触发1次；”10-45/20”代表在[10,45]内步进20秒命中的时间点触发，即10秒触发1次，30秒触发1次

分钟

允许值范围: 0~59 ,不允许为空值，若值不合法，调度器将抛出SchedulerException异常

“*” 代表每隔1分钟触发

“,” 代表在指定的分钟触发，比如”10,20,40”代表10分钟、20分钟和40分钟时触发任务

“-“ 代表在指定的范围内触发，比如”5-30”代表从5分钟开始触发到30分钟结束触发，每隔1分钟触发

“/“ 代表触发步进(step)，”/“前面的值代表初始值(““等同”0”)，后面的值代表偏移量，比如”0/25”或者”/25”代表从0分钟开始，每隔25分钟触发1次，即0分钟触发1次，第25分钟触发1次，第50分钟触发1次；”5/25”代表5分钟触发1次，30分钟触发1次，55分钟触发1次；”10-45/20”代表在[10,45]内步进20分钟命中的时间点触发，即10分钟触发1次，30分钟触发1次

小时

允许值范围: 0~23 ,不允许为空值，若值不合法，调度器将抛出SchedulerException异常

“*” 代表每隔1小时触发

“,” 代表在指定的时间点触发，比如”10,20,23”代表10点钟、20点钟和23点触发任务

“-“ 代表在指定的时间段内触发，比如”20-23”代表从20点开始触发到23点结束触发，每隔1小时触发

“/“ 代表触发步进(step)，”/“前面的值代表初始值(““等同”0”)，后面的值代表偏移量，比如”0/1”或者”/1”代表从0点开始触发，每隔1小时触发1次；”1/2”代表从1点开始触发，以后每隔2小时触发一次

日期

允许值范围: 1~12 (JAN-DEC),不允许为空值，若值不合法，调度器将抛出SchedulerException异常

“*” 代表每个月都触发

“,” 代表在指定的月份触发，比如”1,6,12”代表1月份、6月份和12月份触发任务

“-“ 代表在指定的月份范围内触发，比如”1-6”代表从1月份开始触发到6月份结束触发，每隔1个月触发

“/“ 代表触发步进(step)，”/“前面的值代表初始值(““等同”1”)，后面的值代表偏移量，比如”1/2”或者”/2”代表从1月份开始触发，每隔2个月触发1次；”6/6”代表从6月份开始触发，以后每隔6个月触发一次；”1-6/12”表达式意味着每年1月份触发

星期

允许值范围: 1~7 (SUN-SAT),1代表星期天(一星期的第一天)，以此类推，7代表星期六(一星期的最后一天)，不允许为空值，若值不合法，调度器将抛出SchedulerException异常

“*” 代表每星期都触发；

“?” 与{日期}互斥，即意味着若明确指定{日期}触发，则表示{星期}无意义，以免引起冲突和混乱

“,” 代表在指定的星期约定触发，比如”1,3,5”代表星期天、星期二和星期四触发

“-“ 代表在指定的星期范围内触发，比如”2-4”代表从星期一开始触发到星期三结束触发，每隔1天触发

“/“ 代表触发步进(step)，”/“前面的值代表初始值(““等同”1”)，后面的值代表偏移量，比如”1/3”或者”/3”代表从星期天开始触发，每隔3天触发1次；”1-5/2”表达式意味着在[1,5]范围内，每隔2天触发，即星期天、星期二、星期四触发

“L” 如果{星期}占位符如果是”L”，即意味着星期的的最后一天触发，即星期六触发，L= 7或者 L = SAT，因此，”5L”意味着一个月的最后一个星期四触发

“#” 用来指定具体的周数，”#”前面代表星期，”#”后面代表本月第几周，比如”2#2”表示本月第二周的星期一，”5#3”表示本月第三周的星期四，因此，”5L”这种形式只不过是”#”的特殊形式而已

年份

允许值范围: 1970~2099 ,允许为空，若值不合法，调度器将抛出SchedulerException异常

“*”代表每年都触发

“,”代表在指定的年份才触发，比如”2011,2012,2013”代表2011年、2012年和2013年触发任务

“-“代表在指定的年份范围内触发，比如”2011-2020”代表从2011年开始触发到2020年结束触发，每隔1年触发

“/“代表触发步进(step)，”/“前面的值代表初始值(““等同”1970”)，后面的值代表偏移量，比如”2011/2”或者”/2”代表从2011年开始触发，每隔2年触发1次

注意：除了{日期}和{星期}可以使用”?”来实现互斥，表达无意义的信息之外，其他占位符都要具有具体的时间含义，且依赖关系为：年->月->日期(星期)->小时->分钟->秒数

特殊字符

符号	名称	功能
*	星号	表示重复对应位置上的周期，比如在第四位上表示每日
,	逗号	代表一个列表值，表示多个指定时间，如周位上SAT,SUN表示每周六周日
?	问号	无意义，占位符，只能在日、周位上
-	减号	表示一个范围，如时位上 20-22表示 20、21、22点
/	斜杠	a/b 可以表示以 a 为起点步长为 b 的时间序列，如日位上10/10表示10日20日30日
L	Last	月份最后一天或星期六，周位上 6L 表示月份的最后一个周五
W	Weekday	后边最近的工作日，3W 3日如是周五，则在6日（周一）执行
#	井号	a#b 表示当月第 b 个星期 a，如 6#1 当月第一个星期五
C	Calendar	关联的“日历”的计算结果

周位上给定值后，在日位上要用 ?
“L” 和 “W” 可在日位中联合使用，LW 表示这个月最后一周的工作日
“W” 字符指定的最近工作日是不能跨月
W 字符串只能指定单一日期，而不能指定日期范围
日位建议最大值为 28 ，因为 2 月有时候是 28 天

星期对照：

0 或 7=Sun, 1=Mon, 2=Tue, 3=Wed, 4=Thu, 5=Fri, 6=Sat
1,3,5=Mon,Wed,Fri

“*”

“”字符被用来指定所有的值。如：”“在分钟的字段域里表示“每分钟”。

“?”

“?”字符只在日期域和星期域中使用。它被用来指定“非明确的值”。当你需要通过在这两个域中的一个来指定一些东西的时候，它是有用的。看下面的例子你就会明白。月份中的日期和星期中的日期这两个元素时互斥的一起应该通过设置一个问号来表明不想设置那个字段。

“-”

“-”字符被用来指定一个范围。如：“10-12”在小时域意味着“10点、11点、12点”。

“,”

“,”字符被用来指定另外的值。如：“MON,WED,FRI”在星期域里表示”星期一、星期三、星期五”。

“/”

“/”字符用于指定增量。如：“0/15”在秒域意思是每分钟的0，15，30和45秒。“5/15”在分钟域表示每小时的5，20，35和50。符号“”在“/”前面（如：/10）等价于0在“/”前面（如：0/10）。记住一条本质：表达式的每个数值域都是一个有最大值和最小值的集合，如：秒域和分钟域的集合是0-59，日期域是1-31，月份域是1-12。字符“/”可以帮助你在每个字符域中取相应的数值。如：“7/6”在月份域的时候只有当7月的时候才会触发，并不是表示每个6月。

“L”

L是‘last’的省略写法可以表示day-of-month和day-of-week域，但在两个字段中的意思不同，例如day-of-month域中表示一个月的最后一天。如果在day-of-week域表示‘7’或者‘SAT’，如果在day-of-week域中前面加上数字，它表示一个月的最后几天，例如‘6L’就表示一个月的最后一个星期五。

“W”

字符“W”只允许日期域出现。这个字符用于指定日期的最近工作日。例如：如果你在日期域中写 “15W”，表示：这个月15号最近的工作日。所以，如果15号是周六，则任务会在14号触发。如果15好是周日，则任务会在周一也就是16号触发。如果是在日期域填写“1W”即使1号是周六，那么任务也只会在下周一，也就是3号触发，“W”字符指定的最近工作日是不能够跨月份的。字符“W”只能配合一个单独的数值使用，不能够是一个数字段，如：1-15W是错误的。

“L”和“W”可以在日期域中联合使用，LW表示这个月最后一周的工作日。

“#”

字符“#”只允许在星期域中出现。这个字符用于指定本月的某某天。例如：“6#3”表示本月第三周的星期五（6表示星期五，3表示第三周）。“2#1”表示本月第一周的星期一。“4#5”表示第五周的星期三。

“C”

字符“C”允许在日期域和星期域出现。这个字符依靠一个指定的“日历”。也就是说这个表达式的值依赖于相关的“日历”的计算结果，如果没有“日历”关联，则等价于所有包含的“日历”。如：日期域是“5C”表示关联“日历”中第一天，或者这个月开始的第一天的后5天。星期域是“1C”表示关联“日历”中第一天，或者星期的第一天的后1天，也就是周日的后一天（周一）。

Example

# 每五分钟
0 5 * * * ?
# 每天 5 点半
0 30 5 * * ?
# 每周五 18:18
0 18 18 ? * FRI *
# 每天 8 点到 23 点，每小时
1 1 8-23 * * ?
# 周一到周五每天 8 点到 22 点，每三小时
1 1 8-22/3 ? * MON-FRI
# 当月 13日 10:30 14:30 17:30
30 10,14,17 13 * *
# 每天 6 到 8 点，每 10 分钟
*/10 6-8 * * *
# At 00:05 on Monday
5 0 * * 1
"0 0 12 * * ?" 每天中午12点触发
"0 15 10 ? * *" 每天上午10:15触发
"0 15 10 * * ?" 每天上午10:15触发
"0 15 10 * * ? *" 每天上午10:15触发
"0 15 10 * * ? 2005" 2005年的每天上午10:15触发
"0 * 14 * * ?" 在每天下午2点到下午2:59期间的每1分钟触发
"0 0/5 14 * * ?" 在每天下午2点到下午2:55期间的每5分钟触发
"0 0/5 14,18 * * ?" 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
"0 0-5 14 * * ?" 在每天下午2点到下午2:05期间的每1分钟触发
"0 10,44 14 ? 3 WED" 每年三月的星期三的下午2:10和2:44触发
"0 15 10 ? * MON-FRI" 周一至周五的上午10:15触发
"0 15 10 15 * ?" 每月15日上午10:15触发
"0 15 10 L * ?" 每月最后一日的上午10:15触发
"0 15 10 ? * 6L" 每月的最后一个星期五上午10:15触发
"0 15 10 ? * 6L 2002-2005" 2002年至2005年的每月的最后一个星期五上午10:15触发
"0 15 10 ? * 6#3" 每月的第三个星期五上午10:15触发

VPS设置定时任务

Ubuntu

# 格式是：分 时 日 月 星期 要运行的命令
# week (0 - 6) = sun,mon,tue,wed,thu,fri,sat
# Example of job definition:
# .---------------- minute (0 - 59)
# |  .------------- hour (0 - 23)
# |  |  .---------- day of month (1 - 31)
# |  |  |  .------- month (1 - 12) OR jan,feb,mar,apr ...
# |  |  |  |  .---- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,...,sat
# |  |  |  |  |
# *  *  *  *  * user-name command to be executed
# 编辑修改，centOS 可用 vi /etc/crontab，i 进入编辑状态，:q 退出 :wq 保存退出
sudo nano /etc/crontab
# 监控日志 cron_log 手动创建
*/1 * * * * /bin/date >> /home/cron_log/log_$(date +\%Y-\%m\%d-\%H\%M)
 # 生效一下
crontab /etc/crontab
# 看到的生效的
crontab -l
# 观察执行情况
tail -f /var/log/cron
# 查看最近的 crontab 执行情况
tail -f /var/spool/mail/root
# 其他的与 MAC 差不多，不累述

执行命令行示例：

# 执行 PHP 脚本:
/usr/bin/php /home/username/public_html/cron.php

# 执行 Python 脚本:
/home/miniconda3/envs/my_env/bin/python /home/do.py

# 执行 MySQL dump 备份:
mysqldump -u root -pPASSWORD database > /root/db.sql

# 获取 URL 信息:
/usr/bin/wget --spider "http://www.domain.com/cron.php"

Windows 设置定时任务

不支持，可以使用我的电脑 - 右键‘管理’ - 任务计划程序进行操作。

Mac 设置定时任务

# 查看是否启动
sudo launchctl list | grep cron
# 如无文件，创建一个
sudo touch /etc/crontab
vi /etc/crontab
crontab /etc/crontab
# 状态操作
sudo /usr/sbin/cron start | restart | stop
# 查看已有任务列表
sudo crontab -l
# 编辑任务
sudo crontab -e
# 保存并退款 esc，wq!保存，目测即可生效
# 删除 crontab 文件
sudo crontab -r
# 不执行(如:python)可能要增加 cron 的 Full Disk Access 权限
# System Preferences > Security & Privacy > Privacy > Full Disk Access:
# command+shift+G GOTO: /usr/sbin/cron, 选择 cron
# 可检查是否文件权限问题
cd /Users/gai/Documents/Dev/bin/
chmod +x auto_run.sh

crontab 的文件格式：

分 时 日 月 星期 要运行的命令
* 第1列分钟0～59
* 第2列小时0～23（0表示子夜）
* 第3列日1～31
* 第4列月1～12
* 第5列星期0～7（0和7表示星期天）
* 第6列要运行的命令

脚本命令中带参数写法：

# 时间参数会解析成 2019-0911-2243，多条命令用 & 连接
15 11 * * * touch "/tmp/task-$(date +\%Y-\%m\%d-\%H\%M).sql"
# 每分钟会在文档里增加一条时间记录
*/1*/1 * * * * /bin/date >> /Users/hui/Downloads/time.txt
# 如执行脚本
*/1 * * * * /bin/sh /Dev/bin/auto_run.sh
# 如 查看 crontab 环境变量
* * * * * env >> /Users/gai/Downloads/envs.txt

如果 cron 任务有错误，系统会发信给本机 /var/mail/$user，打开终端会看到 You have new mail.，输入 mail 可查看，阅读完后删除 $user 文件即可。

代码应用

JAVA

@Component
public class ScheduleTask {
// 每天5点半
    @Scheduled(cron = "0 30 5 * * ?")
}

JavaScript

var CronJob = require('cron').CronJob;
new CronJob('* * * * * *', function() {
  console.log('You will see this message every second');
}, null, true, 'America/Los_Angeles');