https://blog.waihost.com/tags/crontab/Recent content in Crontab on 吾爱主机Hugo -- gohugo.iozh-cnWed, 12 Mar 2025 11:26:34 +0800https://blog.waihost.com/posts/cron-expression-guide/Wed, 12 Mar 2025 11:26:34 +0800https://blog.waihost.com/posts/cron-expression-guide/<img src="https://blog.waihost.com/images/covers/cron-expression-guide.svg" alt="Featured image of post 如何正确的编写cron表达式" /><p>正确编写cron表达式需要遵循特定的结构和规则。以下是分步指南：</p> <h3 id="1-确定cron实现环境"><a href="#1-%e7%a1%ae%e5%ae%9acron%e5%ae%9e%e7%8e%b0%e7%8e%af%e5%a2%83" class="header-anchor"></a><strong>1. 确定cron实现环境</strong> </h3><ul> <li><strong>标准cron（如Linux crontab）</strong>：5个字段，格式为 <code>分钟 小时 日期 月份 星期</code>。</li> <li><strong>扩展实现（如Quartz、Spring）</strong>：可能包含6个字段（<code>秒 分钟 小时 日期 月份 星期</code>）。</li> </ul> <h3 id="2-字段顺序与取值范围"><a href="#2-%e5%ad%97%e6%ae%b5%e9%a1%ba%e5%ba%8f%e4%b8%8e%e5%8f%96%e5%80%bc%e8%8c%83%e5%9b%b4" class="header-anchor"></a><strong>2. 字段顺序与取值范围</strong> </h3><table> <thead> <tr> <th>字段</th> <th>取值范围</th> <th>支持的特殊字符</th> </tr> </thead> <tbody> <tr> <td>分钟</td> <td>0-59</td> <td><code>* , - /</code></td> </tr> <tr> <td>小时</td> <td>0-23</td> <td><code>* , - /</code></td> </tr> <tr> <td>日期</td> <td>1-31</td> <td><code>* , - / ? L W</code>（部分系统支持）</td> </tr> <tr> <td>月份</td> <td>1-12 或 JAN-DEC</td> <td><code>* , - /</code></td> </tr> <tr> <td>星期</td> <td>0-7（0和7均为周日，1=周一）</td> <td><code>* , - / ? L #</code>（部分系统支持）</td> </tr> <tr> <td>秒（扩展）</td> <td>0-59</td> <td><code>* , - /</code></td> </tr> </tbody> </table> <h3 id="3-特殊字符用法"><a href="#3-%e7%89%b9%e6%ae%8a%e5%ad%97%e7%ac%a6%e7%94%a8%e6%b3%95" class="header-anchor"></a><strong>3. 特殊字符用法</strong> </h3><ul> <li><code>*</code>：所有值（如每分钟）。</li> <li><code>,</code>：分隔多个值（如 <code>1,3,5</code> 表示1、3、5）。</li> <li><code>-</code>：定义范围（如 <code>10-20</code> 表示10到20）。</li> <li><code>/</code>：步长（如 <code>*/15</code> 表示每15分钟）。</li> <li><code>?</code>：不指定值（用于日期或星期字段，避免冲突）。</li> <li><code>L</code>：最后一天（如 <code>L</code> 在日期字段表示月末）。</li> <li><code>W</code>：最近工作日（如 <code>15W</code> 表示最接近15号的工作日）。</li> <li><code>#</code>：第几个星期几（如 <code>1#3</code> 表示第三个周一，仅部分系统支持）。</li> </ul> <h3 id="4-编写规则"><a href="#4-%e7%bc%96%e5%86%99%e8%a7%84%e5%88%99" class="header-anchor"></a><strong>4. 编写规则</strong> </h3><ul> <li><strong>避免冲突</strong>：日期和星期字段通常不同时指定具体值，用 <code>?</code> 忽略其中一个。</li> <li><strong>转义字符</strong>：部分系统需转义特殊字符（如 <code>\%</code>）。</li> <li><strong>大小写</strong>：月份/星期缩写通常不区分大小写（如 <code>MON</code> 或 <code>mon</code>）。</li> </ul> <h3 id="5-常用示例"><a href="#5-%e5%b8%b8%e7%94%a8%e7%a4%ba%e4%be%8b" class="header-anchor"></a><strong>5. 常用示例</strong> </h3><ul> <li><strong>每5分钟执行一次</strong>：<code>*/5 * * * *</code></li> <li><strong>每天中午12点</strong>：<code>0 12 * * *</code></li> <li><strong>每周一上午9点</strong>：<code>0 9 * * 1</code></li> <li><strong>每月1号0点</strong>：<code>0 0 1 * *</code></li> <li><strong>工作日（周一至周五）上午9点</strong>：<code>0 9 * * 1-5</code></li> <li><strong>每季度最后一天的午夜</strong>（Quartz）：<code>0 0 0 L 3,6,9,12 ?</code></li> </ul> <h3 id="6-验证工具"><a href="#6-%e9%aa%8c%e8%af%81%e5%b7%a5%e5%85%b7" class="header-anchor"></a><strong>6. 验证工具</strong> </h3><ul> <li>使用在线工具检查表达式（如 <a class="link" href="https://crontab.guru/" target="_blank" rel="noopener" >Crontab Guru</a> 或 <a class="link" href="https://www.freeformatter.com/cron-expression-generator-quartz.html" target="_blank" rel="noopener" >Cron Expression Generator</a>）。</li> </ul> <h3 id="7-常见错误"><a href="#7-%e5%b8%b8%e8%a7%81%e9%94%99%e8%af%af" class="header-anchor"></a><strong>7. 常见错误</strong> </h3><ul> <li><strong>字段顺序错误</strong>：如混淆分钟和小时。</li> <li><strong>超出取值范围</strong>：如小时设为24。</li> <li><strong>不支持的字符</strong>：在标准cron中使用 <code>?</code> 或 <code>L</code>（需确认系统支持）。</li> </ul> <h3 id="示例解析"><a href="#%e7%a4%ba%e4%be%8b%e8%a7%a3%e6%9e%90" class="header-anchor"></a><strong>示例解析</strong> </h3><ul> <li><code>0 0/30 9-17 ? * MON-FRI</code>（Quartz）<br> 含义：工作日9:00到17:30之间，每30分钟执行一次（含9:00和17:30）。</li> </ul> <p>通过明确环境、遵循字段规则、合理使用特殊字符，即可编写准确的cron表达式。</p>