Spring Cron Expression

来源：互联网发布：淘宝精品橱窗怎么设置编辑：程序博客网时间：2024/05/17 06:01

Spring Cron Expression

一、简介

CRON表达式是由6个或7个由空格分隔的元素组成的字符串，这些元素可以包含任何允许的值，以及该元素所允许的特殊字符的不同组合。元素如下：
表1-1 CRON表达式允许的元素和值

元素是否必须允许的值允许的特殊字符秒 Y 0-59 , - * / 分钟 Y 0-59 , - * / 小时 Y 0-23 , - * / 日期 Y 1-31 , - * ? / L W 月份 Y 1-12 或者 JAN-DEC , - * / 星期 Y 1-7 或者 SUN-SAT , - * ? / L # 年份 N 空或者 1970-2199 , - * /

二、特殊字符说明

*：用来指定所有值。例如，如果元素分钟为“*”，那么就表示每一分钟；
?：用来表示无指定值。只有日期和星期这两个元素可以使用“？”。当你想要指定这两个元素中的一个元素的值时非常有用，因为日期和星期不能同时设值。例如，如果想在某个月特定的一天（比如10号）触发，但是不管那一天是星期几，则可以将元素日期的值设置为“10”，元素星期的值设置为“？”；
-：用来指定范围内的值。例如，元素小时为“10-12”，则表示10点、11点、12点；
,：用来分隔一个元素的多个值。例如，元素星期为”MON,WED,FRI”，则表示周一、周三和周五；
/：用来表示增量。例如，元素秒为“0/15”，则表示第0秒, 15秒，30秒以及45秒。元素秒为“5/15”, 则表示”第5秒，20秒,35秒以及50秒”。在”/”前指定“*”等价于在”/”前指定0作为起始值。对于表达式的每个元素都有数字范围，具体参见表1-1，”/”只是在给定值范围内每隔N触发。因此请特别注意，月份为”7/6”，表示仅在7月份触发，并不是每6个月触发一次。斜杠前的数字表示起始值，后面的数字表示增量。
L：只能用于“日期”和“星期”这两个元素。这个字符是“last”的缩写，但是对于这两个不同的元素，有着不同的含义。例如，对于日期元素，值“L”代表“这个月的最后一天”——1月份是31号，闰年的二月份是28号。如果“L”用于星期元素，则简单的表示“7”或者“SAT”；但是如果它跟在数字后面用于星期元素，则表示“这个月最后的XXX天”——例如“6L”或者“FRIL”都表示“这个月最后一个星期五”。你也可以从某个月的最后一天指定一个偏移量，例如“L-3”表示历月的倒数第3天。注意，当使用选项“L”时，不要指定列表值或者范围值，否则结果会让你比较困惑。
W：用来指定离给定日期最近的工作日(星期一至星期五)，只能用于日期元素。例如，15W，则表示离这个月15号最近的工作日。如果15号是星期六，那么触发器将会在14号星期五触发。如果15号是星期天，那么触发器将会在16号星期一触发。如果15号是星期二，那么它将在15号星期二触发。然而如果你指定“日期”元素的值为“1W”，并且1号是星期六，触发器将在3号星期一触发,它不会跨跃一个月的天数边界。只有当日期是单一的一天才能指定“W”，而不能是一个日期范围或者列表。
#：只能用于元素星期。该字符用来指定这个月第N个星期X。例如“6#3”，它表示这个月第三个星期五(6 =星期五，”#3” =这个月第三个)。再如，“2#1”表示这个月第一个星期一, “4#5”表示这个月第五个星期四。注意如果你指定”#5”并且这个月没有5个给定的星期，那么这个月将不会触发。如果使用字符’#’，元素星期只能使用一个表达式（”3#1,6#3” 是无效的，因为有两个表达式）。#前面的数字代表星期几，后面的数字表示是第几个。

三、配置示例

下面是CRON表达式的一些配置示例：

表达式含义 0 0 12 * * ? 每天中午12:00触发 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:00到2:59，每分钟触发一次 0 0/5 14 * * ? 每天，从下午2:00到2:55，每五分钟触发一次 0 0/5 14,18 * * ? 每天，从下午2:00到2:55，每五分钟触发一次，并且从下午6:00到6:55，每五分钟触发一次 0 0-5 14 * * ? 每天，从下午2:00到2:05，每分钟触发一次 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, 2003, 2004以及2005年的每个月最后一个星期五上午10:15触发 0 15 10 ? * 6#3 每个月第三个星期五的上午10:15触发 0 0 12 1/5 * ? 每个月从第一天中午12:00开始，每5天触发一次 0 11 11 11 11 ? 每年11月11日上午11:11触发 0 0 23-7/2,8 * * ? 晚上11点到早上8点之间每两个小时触发一次，早上八点触发一次

四、注意事项

1、本文档基于Quartz 2.2.X。
2、支持范围溢出，即左边的值比右边的值大。例如，可以使用“22-2”来表示当天
晚上10点到第二天凌晨2点, 或者也可以使用“NOV-FEB”。过度使用范围溢出来创建范围没有任何意义。

0 0