Cronb表达式.docVIP

Cronb表达式 Popeye有两种任务执行时间策略的表示方式，其中一种是采用Cron表达式来表示任务执行策略。对表达式的解析和根据表达式对任务调度的功能实现，Popeye直接采纳了quartz。下面是quartz有关其支持的cron表达式的格式说明 一个cron表达式实则是一个由6到7个(时间分量)域组成的字符串，时间域之间必须用空格分开，其中的前六个域是必需的，最后一个则是可选择的，如下： 域名 取值 允许使用的特殊字符 秒 0－59 , - * / 分钟 0－59 , - * / 小时 0－23 , - * / 日期 1－31 , - * ? / L W C 月份 1－12或JAN－DEC , - * ? / L C # 星期 1－7或SUN－SAT(星期天为1) , - * ? / L C # 年(可选) 不设置或者1970－2099 , - * / 其中 ● 特殊字符星号’*’表示匹配任何值。比如分钟域设为*表示每一分钟。 ● 问号’?’可被用于日期域和星期域中，在只需设置这两个域中的其中一个时，可用它表示不设定特定的值，见后面的例子。 ● 横杠’-’ 表示一个时间范围。比如小时域设为”10-12”表示10、11、12时。 ● 逗号’,’用于设置多个值。比如MON,WED,FRI表示星期一、三、五。 ● 斜杠’/’表示分割初始值和增量。比如秒域设成0/15表示第0、15、30、45秒。5/15表示第5、20、35、50秒。在/前设*等同于设初始值为0。本质上，每个域都有各自的取值范围，/字符仅仅是从取值范围中每隔n个取一个值用于匹配，因此如果月份域设置7/6，仅会选中7月，而不是表示7月、13月…请注意这点。 ● 字符’L’ 可被用于日期域和星期域中，表示“last”的缩写。在日期域，’L’表示某个月的最有一天，如1月的31号，平年2月的28号等。而在星期域中，如果单独使用，则仅仅表示星期六(7)；如果跟在一个值之后，则表示当月的最后一个该星期数，如’6L’表示当月的最后一个星期五。在使用’L’项时，不可设置多个值(使用’,’)或一个范围(使用’-’)，否则会产生歧义。 ● 字符’W’可被用于日期域中，是weekday的缩写，用于表示离给定日期最近的那个平日(一周中非星期六、日的一天)。如15W表示离当月15日最近的一个平日，如果15日当天是星期六，则表示14日星期五，如果15日当前是星期天，则表示16号星期一，如果15号当前是星期一到星期五中的某一天，则表示当天。但如果设置为”1W”，且1号当天是星期六，则表示3号星期一，而不会跳到上个月去。使用’W’项也不可设置多个值(使用’,’)或一个范围(使用’-’) ● ‘L’和’W’也可以结合使用，写作’LW’，用于表示一个月中的最后一个平日。 ● 井号”#”可被用于星期域，指定一个月中的第n个星期几。如6#3表示一个月中的第三个星期五。加入设置了”#5”，而改用并没有5个指定的星期几，则该设置无效。 ● 字符’C’可被用于日期域和星期域中，是” calendar”的缩写，表示根据相关的历法取值。如果没有相关历法，则等同于一个包括一切的历法。如日期域中5C表示该历法中5号(包括5号)以后的第一天。星期域中的1C表示该历法中星期天(包括星期天)以后的第一天。 表达式中的合法字符，以及月份名、星期名是不分大小写的。 下面是一些完整的例子： Expression Meaning 0 0 12 * * ? Fire at 12pm (noon) every day 0 15 10 ? * * Fire at 10:15am every day 0 15 10 * * ? Fire at 10:15am every day 0 15 10 * * ? * Fire at 10:15am every day 0 15 10 * * ? 2005 Fire at 10:15am every day during the year 2005 0 * 14 * * ? Fire every minute starting at 2pm and ending at 2:59pm, every day 0 0/5 14 * * ? Fire every 5 minutes starting at 2pm and ending at 2:55pm, every day 0 0/5 14,18 * * ? Fire every 5 minutes starting at 2pm and ending at 2:55pm, AND fire every 5 minutes starting at 6pm and ending at 6:55pm