Quartz时间格式配置说明

本文深入探讨了触发器的高级特性及其在不同场景下的应用,包括但不限于时间表达式的详细解析、特殊字符的使用规则、触发条件的设定与复杂时间范围的设定等。通过丰富的例子展示了如何灵活运用这些特性来实现精准的触发机制。
可用值详细分析如下:

“*”——字符可以用于所有字段,在“分”字段中设为"*"表示"每一分钟"的含义。

“?”——字符可以用在“日”和“周几”字段. 它用来指定 '不明确的值'. 这在你需要指定这两个字段中的某一个值而不是另外一个的时候会被用到。在后面的例子中可以看到其含义。

“-”——字符被用来指定一个值的范围,比如在“小时”字段中设为"10-12"表示"10点到12点"。

“,”——字符指定数个值。比如在“周几”字段中设为"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday"。

“/”——字符用来指定一个值的的增加幅度. 比如在“秒”字段中设置为"0/15"表示"第0, 15, 30, 和 45秒"。而 "5/15"则表示"第5, 20, 35, 和 50". 在'/'前加"*"字符相当于指定从0秒开始. 每个字段都有一系列可以开始或结束的数值。对于“秒”和“分”字段来说,其数值范围为0到59,对于“小时”字段来说其为0到23, 对于“日”字段来说为0到31, 而对于“月”字段来说为1到12。"/"字段仅仅只是帮助你在允许的数值范围内从开始"第n"的值。

“L”——字符可用在“日”和“周几”这两个字段。它是"last"的缩写, 但是在这两个字段中有不同的含义。例如,“日”字段中的"L"表示"一个月中的最后一天" —— 对于一月就是31号对于二月来说就是28号(非闰年)。而在“周几”字段中, 它简单的表示"7" or "SAT",但是如果在“周几”字段中使用时跟在某个数字之后, 它表示"该月最后一个星期×" —— 比如"6L"表示"该月最后一个周五"。当使用'L'选项时,指定确定的列表或者范围非常重要,否则你会被结果搞糊涂的。

“W”——可用于“日”字段。用来指定历给定日期最近的工作日(周一到周五) 。比如你将“日”字段设为"15W",意为: "离该月15号最近的工作日"。因此如果15号为周六,触发器会在14号即周五调用。如果15号为周日, 触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将“日”字段设为"1W", 而一号又是周六, 触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。'W'字符只能用于“日”字段的值为单独的一天而不是一系列值的时候。

“L”和“W”可以组合用于“日”字段表示为'LW',意为"该月最后一个工作日"。

“#”—— 字符可用于“周几”字段。该字符表示“该月第几个周×”,比如"6#3"表示该月第三个周五( 6表示周五而"#3"该月第三个)。再比如: "2#1" = 表示该月第一个周一而 "4#5" = 该月第五个周三。注意如果你指定"#5"该月没有第五个“周×”,该月是不会触发的。

“C”—— 字符可用于“日”和“周几”字段,它是"calendar"的缩写。 它表示为基于相关的日历所计算出的值(如果有的话)。如果没有关联的日历, 那它等同于包含全部日历。“日”字段值为"5C"表示"日历中的第一天或者5号以后",“周几”字段值为"1C"则表示"日历中的第一天或者周日以后"。

对于“月份”字段和“周几”字段来说合法的字符都不是大小写敏感的。


字段 允许值 允许的特殊字符
秒 0-59 , - * /
分 0-59 , - * /
小时 0-23 , - * /
日期 1-31 , - * ? / L W C
月份 1-12 或者 JAN-DEC , - * /
星期 1-7 或者 SUN-SAT , - * ? / L C #
年(可选) 留空, 1970-2099 , - * /

字段 允许值 允许的特殊字符
秒 0-59 , - * /
分 0-59 , - * /
小时 0-23 , - * /
日期 1-31 , - * ? / L W C
月份 1-12 或者 JAN-DEC , - * /
星期 1-7 或者 SUN-SAT , - * ? / L C #
年(可选) 留空, 1970-2099 , - * /
表达式意义
"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触发
每天早上6点
0 6 * * *
每两个小时
0 */2 * * *
晚上11点到早上8点之间每两个小时,早上八点
0 23-7/2,8 * * *
每个月的4号和每个礼拜的礼拜一到礼拜三的早上11点
0 11 4 * 1-3
1月1日早上4点
0 4 1 1 *


quartz的高级特性不仅如此
1 数据库存储
2 集群支持
3 数据库持久化任务,trigger
4 trigger 的停止,运行
5 任务的任意添加
6 比corntrigger 更详尽的任务安排
7 线程的内部数据交换
Quartz 框架中,`CronTrigger` 是用于定义基于 cron 表达式触发任务的机制。`CronTrigger` 提供了灵活的时间调度方式,允许开发者通过 cron 表达式精确控制任务的执行时间。 `CronTrigger` 的核心配置主要通过 `CronScheduleBuilder` 来完成,该类提供了多种方法用于构建 cron 调度策略。常见的配置包括指定 cron 表达式、时区、是否可错过触发(misfire handling)等。以下是一个典型的 `CronTrigger` 构建示例: ```java CronTrigger cronTrigger = TriggerBuilder.newTrigger() .withIdentity("trigger1", "group1") .withSchedule(CronScheduleBuilder.cronSchedule("0 0/5 * * * ?")) .build(); ``` 在上述代码中,`CronScheduleBuilder.cronSchedule("0 0/5 * * * ?")` 指定了一个每 5 分钟执行一次的任务调度规则。此 cron 表达式由六个或七个字段组成(可选年份),分别表示秒、分、小时、日、月、周几和年(可选)[^2]。 此外,`CronTrigger` 还支持配置时区,以确保任务在指定的地理区域时间执行。例如: ```java CronScheduleBuilder.cronSchedule(TimeZone.getTimeZone("America/New_York"), "0 0/5 * * * ?") ``` 对于 misfire 情况的处理,Quartz 提供了多种策略,如 `MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY`、`MISFIRE_INSTRUCTION_FIRE_ONCE_NOW` 等。这些策略可以通过 `withMisfireHandlingInstruction` 方法应用到 `CronTrigger` 上。 ### Cron 表达式语法 Quartz 的 cron 表达式语法支持多个特殊字符,包括星号(*)、问号(?)、连字符(-)、斜杠(/)、逗号(,)和 L、W、# 等特定字符。这些特殊字符允许定义复杂的调度逻辑,例如: - 星号(*)表示任意值。 - 问号(?)表示不指定值,通常用于日和周几字段中,以避免冲突。 - 连字符(-)定义一个值的范围。 - 斜杠(/)定义递增的步长。 - 逗号(,)列出多个值。 - L 表示最后一天或最后一个星期几。 - W 表示最近的工作日。 - # 用于指定第几个星期几。 例如,表达式 `0 0 12 ? * SUN#2` 表示“每个月的第二个星期日的中午 12:00”执行任务。 ### 在线 Cron 表达式生成器 为了简化 cron 表达式的编写过程,可以使用在线 cron 表达式生成器工具。这些工具通常提供图形界面,让用户选择时间参数,然后自动生成相应的 cron 表达式。这有助于减少手动编写时可能出现的错误,并提高开发效率。 ### Quartz 与 Spring Boot 整合 当 Quartz 与 Spring Boot 整合时,可以通过配置类来定义 `CronTrigger`。在 Spring Boot 中,通常会创建一个配置类,使用 `@Bean` 注解来声明 `CronTrigger` 实例。例如: ```java @Configuration public class QuartzConfig { @Bean public CronTrigger cronTrigger(JobDetail jobDetail) { return TriggerBuilder.newTrigger() .forJob(jobDetail) .withIdentity("cronTrigger", "group1") .withSchedule(CronScheduleBuilder.cronSchedule("0 0/5 * * * ?")) .build(); } } ``` 在上述配置中,`jobDetail` 是一个已经定义好的 `JobDetail` 对象,它指定了要执行的任务类。通过这种方式,可以将 `CronTrigger` 与具体的任务关联起来,并在 Spring Boot 应用程序启动时自动注册到 Quartz 调度器中。 ### 数据库支持 Quartz 支持将任务和触发器的信息存储在数据库中,以便在应用程序重启后仍然能够保留任务状态。为此,需要预先创建一系列数据库表,这些表共同支撑了 Quartz 的任务调度功能,既支持单机调度,也支持分布式集群环境。[^3] 在 Spring Boot 项目中,除了需要添加 Quartz 的 Maven 依赖外,还需要配置数据源和 Quartz 的相关属性。通常会在 `application.properties` 文件中配置数据源信息,并在 `quartz.properties` 文件中设置 Quartz 的调度器参数。例如: ```properties # application.properties spring.datasource.url=jdbc:mysql://localhost:3306/quartz_db spring.datasource.username=root spring.datasource.password=root spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver # quartz.properties org.quartz.scheduler.instanceName=MyScheduler org.quartz.threadPool.threadCount=10 org.quartz.jobStore.class=org.quartz.impl.jdbcjobstore.JobStoreTX org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.StdJDBCDelegate org.quartz.jobStore.dataSource=myDS org.quartz.jobStore.tablePrefix=QRTZ_ org.quartz.dataSource.myDS.driver=com.mysql.cj.jdbc.Driver org.quartz.dataSource.myDS.URL=jdbc:mysql://localhost:3306/quartz_db org.quartz.dataSource.myDS.user=root org.quartz.dataSource.myDS.password=root org.quartz.dataSource.myDS.maxConnections=5 ``` 通过上述配置Quartz 将使用 MySQL 数据库来持久化任务和触发器信息,从而实现任务状态的持久化存储。 ### 示例输出日志 当 Quartz 调度器成功启动并开始执行任务时,控制台会输出类似以下的日志信息: ``` [main] INFO org.quartz.impl.StdSchedulerFactory - Quartz scheduler version: 2.3.0 1633149326723 任务执行。。。 Sat Oct 02 12:35:26 CST 2021 Sat Oct 02 12:36:26 CST 2021 [main] INFO org.quartz.core.QuartzScheduler - Scheduler DefaultQuartzScheduler_$_NON_CLUSTERED started. ``` 这些日志信息表明调度器已经正确启动,并且任务正在按照预定的时间表执行。 ###
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值