Cron 表达式

1. Cron 表达式

 一个Cron表达式有至少6个(也可能是7个)由空格分隔的时间元素:

元素

是否必须

允许的值

允许的特殊字符

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

, - * /


2. Cron 表达式的特殊字符

  • *:用来指定所有值。例如,如果元素分钟为“*”,那么就表示每一分钟;
  • ?:用来表示无指定值。只有日期和星期这两个元素可以使用“?”。当你想要指定这两个元素中的一个元素的值时非常有用,因为日期和星期不能同时设值。例如,如果想在某个月特定的一天(比如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" 是无效的,因为有两个表达式)。#前面的数字代表星期几,后面的数字表示是第几个。
  • L和W:可以组合用于“日”字段表示为'LW',意为"该月最后一个工作日"。
  • C:字符可用于“日”和“周几”字段,它是"calendar"的缩写。它表示为基于相关的日历所计算出的值(如果有的话)。如果没有关联的日历,那它等同于包含全部日历。“日”字段值为"5C"表示"日历中的第一天或者5号以后",“周几”字段值为"1C"则表示"日历中的第一天或者周日以后"。对于“月份”字段和“周几”字段来说合法的字符都不是大小写敏感的。

3. 配置示例

表达式

含义

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.*
(2) 支持范围溢出,即左边的值比右边的值大。例如,可以使用“22-2”来表示当天
晚上10点到第二天凌晨2点, 或者也可以使用“NOV-FEB”。过度使用范围溢出来创建范围没有任何意义。

<think>好的,我现在需要帮助用户了解如何编写和解析cron表达式。首先,根据用户提供的引用内容,我需要整理出关键。引用中提到了cron-validator和cron-parser用于验证和解析表达式,还有cron-utils库,以及Java中的CronExpression类。用户可能想知道如何手动编写cron表达式,以及如何用工具或库来解析它们。 首先,我需要解释cron表达式的基本结构。标准的cron表达式有五个或六个字段,别代表钟、小时、日期、月份、星期,和可选的年(在Quartz等扩展版本中)。例如,0 0 12 * * ? 表示每天中午12执行。需要举例说明每个字段的取值范围和特殊字符,比如星号、逗号、连字符、斜杠等。 接下来是编写部。用户可能需要一些常见的例子,比如每执行一次,每天凌晨执行,每周一执行等。这部需要清晰明了,让用户能快速上手。 然后是解析部。用户提到了Java中的CronExpression.getTimeAfter方法,这可能用于计算下次执行时间。需要介绍如何使用现有的库来解析cron表达式,例如在Java中使用cron-utils或SpringCronSequenceGenerator,在Python中使用croniter,JavaScript中使用node-cron等。还要提到在线工具,如用户提到的bejson网站,方便用户快速验证表达式。 另外,用户提供的引用2提到了在开发中生成和解析cron表达式的需求,比如让用户界面设置时间生成表达式,或者解析表达式获取下一次执行时间。这部需要强调库的重要性,避免手动解析的复杂性。 需要注意的是,确保回答中的LaTeX格式正确,行内公式用$...$,独立公式用$$...$$。例如,解释特殊字符时,如果有数学表达式,要用正确的格式。不过cron表达式本身不涉及数学公式,可能用代码块更合适,但根据系统指令,代码块需要用三个反引号包裹,并指定语言。 最后,生成相关问题需要考虑用户可能的后续疑问,比如验证工具、特殊字符的作用、不同语言的库推荐、如何获取下次执行时间,以及常见错误等。这些问题应该覆盖用户可能遇到的实际应用场景。 检查是否所有引用都正确标注,比如引用1提到cron-validator和cron-parser,引用2提到在线工具和cron-utils,引用3提到Java的getTimeAfter方法,引用4提到Java中解析表达式的代码示例。需要确保每个引用在回答中的引用标识正确对应。 总结回答结构:先解释cron的结构,然后编写示例,接着解析方法,最后推荐工具和库。相关问题部需要覆盖编写、解析、工具、错误处理等方面的问题。</think>### 如何编写或解析 cron 表达式 #### 1. **编写 cron 表达式** cron 表达式由 **5-7个字段** 组成,别表示时间单位和频率。标准格式为: ``` 秒(可选) 时 日 月 周 [年] ``` 其中 **年** 字段在部工具(如Quartz)中支持。常用字段说明如下: | 字段 | 允许值 | 特殊字符 | 示例 | |------|-----------------|----------------|--------------| | | 0-59 | `* , - /` | `0` 表示整 | | 时 | 0-23 | `* , - /` | `12` 表示中午12 | | 日 | 1-31 | `* , - / ? L` | `15` 表示每月15日 | | 月 | 1-12 或 JAN-DEC | `* , - /` | `*/3` 每3个月 | | 周 | 0-6 或 SUN-SAT | `* , - / ? L #`| `MON` 表示周一 | | 年 | 1970-2099 | `* , - /` | `2023` 仅2023年生效 | **特殊字符说明**: - `*`: 任意值 - `,`: 多个值(如 `1,3,5`) - `-`: 范围(如 `1-5`) - `/`: 步长(如 `0/15` 表示每15钟) - `?`: 日或周字段的占位符(避免冲突) - `L`: 最后一天(如 `L` 表示月末) **常见示例**: - 每天中午12执行:`0 0 12 * * ?` [^3] - 每周一上午9:`0 0 9 ? * MON` - 每5一次:`0 */5 * * * ?` --- #### 2. **解析 cron 表达式** 解析 cron 表达式主要用于 **获取执行计划**(如下次运行时间)或 **验证格式合法性**。常用方法如下: ##### 2.1 **使用工具库** - **Java**: - 通过 `CronExpression` 类解析: ```java CronExpression cron = new CronExpression("0 0 12 * * ?"); Date nextTime = cron.getTimeAfter(new Date()); // 计算下次执行时间 ``` - 使用 `cron-utils` 库生成或解析表达式[^2]。 - **Python**: - 使用 `croniter` 库: ```python from croniter import croniter iter = croniter("0 0 12 * * ?", datetime.now()) next_time = iter.get_next(datetime) ``` - **JavaScript**: - 使用 `node-cron` 或 `cron-parser`[^1]。 ##### 2.2 **在线工具** 通过网站(如 [bejson cron解析工具](https://www.bejson.com/othertools/cron/))直接输入表达式,自动生成执行时间表。 --- #### 3. **注意事项** 1. **字段冲突**:若同时指定 **日** 和 **周** 字段,可能触发未预期行为(如 `?` 用于占位符)。 2. **时区问题**:需明确表达式基于的时区(如服务器时区)。 3. **闰年处理**:部工具可能不支持 `L` 在2月的特殊逻辑。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值