quarz_crontab_parse

将复杂难懂的quarzcrontab表达式转换为中文

每个域只能输入允许值，可匹配?符号到任何域

不支持W字符

DayOfWeek不支持字符(Sun,Mon,The,Wed,Thr,Fri,Sat)

Usage

安装

npm install quarz_crontab_parse -S

esm环境

import parseCrontab from 'quarz_crontab_parse'

...
const crontabCn = parseCrontab('0 15 10 ? * 2-6')
console.log(crontabCn)
...

umd环境

...
const crontabCn = parseCrontab('0 15 10 ? * 2-6')
console.log(crontabCn)
...

cjs环境

...
const parseCrontab = require('quarz_crontab_parse')
const crontabCn = parseCrontab('0 15 10 ? * 2-6')
console.log(crontabCn)
...

常用表达式

常用表达式

限制条件

| 字段 | 允许值 | 允许的特殊字符 | |----------------|:---------------------------------------:|---------------| | 秒（Seconds） | 0~59的整数 | , - / * # ? | | 分（Minutes） | 0~59的整数 | , - / * # ? | | 小时（Hours） | 0~23的整数 | , - / * # ? | | 日期（DayofMonth） | 1~31的整数（需要考虑你月的天数） | ,- * ? / # L | | 月份（Month） | 1~12的整数 | , - * # / ? | | 星期（DayofWeek） | 1~7的整数 | , - * # ? / L | | 年(可选，留空)（Year） | 1970~2099 | , - * ? / |

解析规则

/：表示起始时间开始触发，然后每隔固定时间触发一次。

范围值 + 开始值 - 间隔值 = 范围内最后执行的值

例如在Hours域使用3/4，则意味着从第3小时到24+3-4：23小时范围内，第3小时开始触发第一次，然后每隔4小时，即7，11，15，19，23小时等分别触发一次。

例如在Minutes域使用5/20，则意味着从第5分钟到60+5-20：45分范围内，第5分钟开始触发第一次，然后每隔20分钟，即25，45分钟等分别触发一次。

例如在Seconds域使用8/10，则意味着从第8秒到60+8-10：58秒范围内，第8秒开始触发第一次，然后每隔10秒，即18，28，38，48，58秒等分别触发一次。

*****：表示匹配该域的任意值。

例如在Minutes域使用*， 即表示每分钟都会触发事件。

?：表示只能用在DayOfMonth和DayOfWeek两个域，其作用为不指定

-：表示范围。

例如在Minutes域使用5-20，表示从5分到20分钟每分钟触发一次

,：表示列出枚举值。

例如在Minutes域使用5，20，则意味着在5和20分每分钟触发一次。

L：表示最后，只能出现在DayOfWeek和DayOfMonth域。

如果出现在DayOfMonth域，只能使用L，表示当月最后一天 如果在DayOfWeek域 使用数字（1-7）或L（和7的作用一样表示每周的最后一天周六），比如数字"5"表示每周4，"7"或"L"表示每周六 使用数字（1-7）结合L，表示当月最后一周的周几，比如"5L" 表示在最后的一周的周四；"3L" 表示最后一周的周二

#：用于确定每个月第几个星期几，只能出现在DayofMonth域。

例如 "4#2" 表示某月的第二个星期三（4表示星期三，2表示第二周）; “6#3”表示本月第三周的星期五（6表示星期五，3表示第三周）; “2#1”表示本月第一周的星期一; “4#5”表示第五周的星期三。