Cron表达式

概述

Cron表达式通常用在定时任务中,主要用来设置定时任务的触发时间,如每天一点执行一次等,下面所说的就是Quartz中会使用到Cron表达式。

Cron表达式支持7个字段,分别是。也就是我们常说的"年月日时分秒",只是在"年"和"月"之间多个"周"而已。其中是可选项,各个字段之间通过空格进行分隔,如果不加上"年"则是六项,如果加上"年"则是七项,所以很好区分是否加上了"年"。

Cron表达式所允许的值和一些特殊字符如下表所示:

名称是否必须允许值特殊字符
0-59, - * /
0-59, - * /
0-23, - * /
1-31, - * ? / L W C
1-12或JAN-DEC, - * /
1-7或SUN-SAT, - * ? / L C #
空或1970-2099, - * /

注意:

  • 中1表示周日,2才表示周一,以此类推,7表示周六。
  • 在cron表达式中不区分大小写,即sun和SUN等价。

Cron表达式中特殊字符的说明

  • *:可用在所有字段中,表示对应时间域的每一个时刻。如在字段时表示"每分钟";在字段时表示"每天"。
  • ?:该特殊字符只在字段中使用,通常指定为无意义的值,相当于占位符,仅占位不发挥作用。
  • -:表示范围,包括起始边界和结束边界。如在字段使用10-12表示从10点到12点,即10,11,12,注意它是包括10和12的。
  • ,表达一系列特定值。如在字段使用1,3,5,7,9表示1号、3号、5号、7号、9号。注意与-字符不同的是:-指定范围要求是连续的;,指定一系列值,可以是离散的,也可以是连续的,如10-12等价于10,11,12
  • /x/y表示一个等步长序列,其中x为起始值,y为步长值。如在 字段中使用0/15则表示0,15,30,45分;如5/15字段中表示5,20,35,50;还可以使用*/y等同于0/y
  • L:该字符只在字段中使用,表示"Last"的意思。但在两个字段中又有所区别,L字段中表示这个月的最后一天,如一月的31号、非闰年二月的28号;L中单独使用则表示周六,等价于数字7L中不单独使用,前面还有一个数值X,则表示这个月的最后星期X-1,如6L表示该月的最后星期五。
  • W:该字符只在字段中使用,一般是对面日期的修饰,表示离该日期最近的工作日。如15W表示离该月15号最近的工作日,如果该月15号是星期六,则匹配14号星期五;如果15号是星期日,则匹配16号星期一;如果15号是星期二,那结果就是星期二(即如果本身是工作日则匹配本身)。注意关联的匹配日期不能跨月,如指定1W,如果1号是星期六,则结果匹配的是3号的星期一,而非上个月的最后那天星期五。W只能指定单一日期,不能指定日期范围。
  • LW:在字段中LW可以组合使用,表示当月的最后一个工作日。
  • #:该字符只能在字段中使用,表示当月第几个工作日,前后分别有着数字,格式是星期#工作日。如6#3表示本月的第三个星期五(其中6表示星期五,#3表示本月第三个);而4#5表示本月的第五个星期三,如果当月没有第五个星期三则忽略不触发。
  • C:该字符只在字段中使用,表示Calendar的意思。它的意思是计划所关联的日期,如果日期没有被关联,则相当于日历中所有日期。例如5C在日期字段中就相当于日历5日以后的第一天。1C在星期字段中相当于星期日后的第一天。

示例

表达式说明
0 0 12 * * ?每天12点运行
0 15 10 ? * *每天10点15分运行
0 15 10 * * ?每天10点15分运行
0 15 10 * * ? *每天10点15分运行
0 15 10 * * ? 2008在2008年的每天10点15分运行
0 * 14 * * ?每天14点到15点之间每分钟运行一次,开始于14:00,结束于14:59
0 0/5 14 * * ?每天14点到15点每5分钟运行一次,开始于14:00,结束于14:55
0 0/5 14,18 * * ?每天14点到15点每5分钟运行一次,此外每天18点到19点每5钟也运行一次
0 0-5 14 * * ?每天14:00点到14:05,每分钟运行一次
0 10,44 14 ? 3 WED3月的每周三14点10分运行一次、14点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 2007-2009在2007、2008、2009年的每个月的最后一个星期五的10点15分运行
0 15 10 ? * 6#3在每月的第三个星期五的10点15分运行

在线Cron表达式生成器

通常我们只需要大致知道一个cron表达式所代表的意思,不需要我们手动去写,网上有在线的Cron表达式生成器帮助我们快速生成cron表达式。如:https://qqe2.com/cron
在这里插入图片描述我们可以通过上面的分钟小时月份周(星期)年份选项卡来分别设置cron表达式的七个字段的值,通过下面的单选框来设置触发时间,最后生成合适的cron表达式。

<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或Spring的CronSequenceGenerator,在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、付费专栏及课程。

余额充值