Cron定时解析

├── img ├── icon128.png ├── icon16.png ├── icon48.png └── github-logo.svg ├── manifest.json ├── css └── styles.css ├── js ├── popup.js └── cron-parser.js └── popup.html /img/icon128.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/yml2213/cron/HEAD/img/icon128.png -------------------------------------------------------------------------------- /img/icon16.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/yml2213/cron/HEAD/img/icon16.png -------------------------------------------------------------------------------- /img/icon48.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/yml2213/cron/HEAD/img/icon48.png -------------------------------------------------------------------------------- /manifest.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "Cron定时解析", 3 | "description": "一个简单的Cron表达式解析工具", 4 | "version": "2.0.0", 5 | "manifest_version": 3, 6 | "action": { 7 | "default_popup": "popup.html", 8 | "default_icon": { 9 | "16": "img/icon16.png", 10 | "48": "img/icon48.png", 11 | "128": "img/icon128.png" 12 | }, 13 | "default_title": "Cron定时解析" 14 | }, 15 | "icons": { 16 | "16": "img/icon16.png", 17 | "48": "img/icon48.png", 18 | "128": "img/icon128.png" 19 | }, 20 | "permissions": [], 21 | "host_permissions": [] 22 | } -------------------------------------------------------------------------------- /img/github-logo.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /css/styles.css: -------------------------------------------------------------------------------- 1 | /* 基础样式 */ 2 | html, body { 3 | height: 100%; 4 | } 5 | 6 | body { 7 | font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; 8 | width: 800px; /* 增加宽度以适应双栏 */ 9 | height: 500px; 10 | margin: 0; 11 | color: #333; 12 | background-color: #f7f7f7; 13 | display: flex; 14 | flex-direction: column; 15 | } 16 | 17 | .container { 18 | display: flex; 19 | flex-direction: column; 20 | height: 100%; 21 | padding: 16px; 22 | box-sizing: border-box; 23 | } 24 | 25 | h1 { 26 | font-size: 18px; 27 | margin: 0; 28 | color: #333; 29 | } 30 | 31 | h4 { 32 | margin-top: 16px; 33 | margin-bottom: 8px; 34 | color: #2c8898; 35 | } 36 | 37 | /* 头部样式 */ 38 | .header { 39 | display: flex; 40 | justify-content: space-between; 41 | align-items: center; 42 | margin-bottom: 16px; 43 | flex-shrink: 0; 44 | } 45 | 46 | .header-left { 47 | display: flex; 48 | align-items: center; 49 | gap: 8px; 50 | } 51 | 52 | #github-link { 53 | display: inline-flex; 54 | align-items: center; 55 | justify-content: center; 56 | } 57 | 58 | #github-link img { 59 | width: 20px; 60 | height: 20px; 61 | filter: grayscale(1); 62 | transition: filter 0.3s; 63 | } 64 | 65 | #github-link:hover img { 66 | filter: grayscale(0); 67 | } 68 | 69 | /* 主内容区 */ 70 | .main-content { 71 | display: flex; 72 | flex: 1; 73 | gap: 16px; 74 | overflow: hidden; /* 防止子元素溢出 */ 75 | } 76 | 77 | /* 左右面板 */ 78 | .left-panel, .right-panel { 79 | background-color: white; 80 | border-radius: 8px; 81 | border: 1px solid #e0e0e0; 82 | padding: 16px; 83 | box-sizing: border-box; 84 | display: flex; 85 | flex-direction: column; 86 | } 87 | 88 | .left-panel { 89 | flex: 6; /* 左侧更宽 */ 90 | } 91 | 92 | .right-panel { 93 | flex: 4; /* 右侧稍窄 */ 94 | } 95 | 96 | /* 格式切换开关 */ 97 | .format-switch-container { 98 | display: flex; 99 | align-items: center; 100 | } 101 | 102 | .switch { 103 | position: relative; 104 | display: inline-block; 105 | width: 46px; 106 | height: 24px; 107 | margin-right: 10px; 108 | } 109 | 110 | .switch input { 111 | opacity: 0; 112 | width: 0; 113 | height: 0; 114 | } 115 | 116 | .slider { 117 | position: absolute; 118 | cursor: pointer; 119 | top: 0; 120 | left: 0; 121 | right: 0; 122 | bottom: 0; 123 | background-color: #ccc; 124 | transition: .4s; 125 | } 126 | 127 | .slider:before { 128 | position: absolute; 129 | content: ""; 130 | height: 18px; 131 | width: 18px; 132 | left: 3px; 133 | bottom: 3px; 134 | background-color: white; 135 | transition: .4s; 136 | } 137 | 138 | input:checked + .slider { 139 | background-color: #2c8898; 140 | } 141 | 142 | input:focus + .slider { 143 | box-shadow: 0 0 1px #2c8898; 144 | } 145 | 146 | input:checked + .slider:before { 147 | transform: translateX(22px); 148 | } 149 | 150 | .slider.round { 151 | border-radius: 24px; 152 | } 153 | 154 | .slider.round:before { 155 | border-radius: 50%; 156 | } 157 | 158 | /* 表单样式 */ 159 | .input-group { 160 | margin-bottom: 16px; 161 | display: flex; 162 | align-items: center; 163 | gap: 8px; 164 | flex-shrink: 0; 165 | } 166 | 167 | label { 168 | font-weight: 500; 169 | } 170 | 171 | input[type="text"] { 172 | flex: 1; 173 | padding: 8px; 174 | border: 1px solid #ddd; 175 | border-radius: 4px; 176 | box-sizing: border-box; 177 | font-size: 14px; 178 | } 179 | 180 | /* 选项卡样式 */ 181 | .tabs { 182 | display: flex; 183 | border-bottom: 1px solid #ddd; 184 | flex-shrink: 0; 185 | } 186 | 187 | .tab { 188 | padding: 8px 16px; 189 | cursor: pointer; 190 | border-bottom: 2px solid transparent; 191 | transition: all 0.3s; 192 | color: #666; 193 | } 194 | 195 | .tab:hover { 196 | color: #333; 197 | } 198 | 199 | .tab.active { 200 | border-bottom-color: #2c8898; 201 | color: #2c8898; 202 | font-weight: 500; 203 | } 204 | 205 | .tab-content-wrapper { 206 | flex: 1; 207 | overflow-y: auto; 208 | padding-top: 16px; 209 | } 210 | 211 | /* 结果区域样式 */ 212 | .result-wrapper { 213 | flex: 1; 214 | display: flex; 215 | flex-direction: column; 216 | overflow: hidden; 217 | } 218 | 219 | #result-area { 220 | border: 1px solid #ddd; 221 | border-radius: 4px; 222 | padding: 12px; 223 | background-color: #f9f9f9; 224 | flex: 1; 225 | overflow-y: auto; 226 | white-space: pre-wrap; 227 | font-family: monospace; 228 | font-size: 14px; 229 | line-height: 1.6; 230 | } 231 | 232 | /* 表格样式 */ 233 | table { 234 | width: 100%; 235 | border-collapse: collapse; 236 | margin-bottom: 16px; 237 | font-size: 14px; 238 | } 239 | 240 | table, th, td { 241 | border: 1px solid #ddd; 242 | } 243 | 244 | th, td { 245 | padding: 8px; 246 | text-align: left; 247 | } 248 | 249 | th { 250 | background-color: #f2f2f2; 251 | font-weight: 500; 252 | } 253 | 254 | /* 列表样式 */ 255 | ul { 256 | padding-left: 20px; 257 | } 258 | 259 | li { 260 | margin-bottom: 8px; 261 | line-height: 1.5; 262 | } 263 | 264 | code { 265 | background-color: #f0f0f0; 266 | padding: 2px 4px; 267 | border-radius: 3px; 268 | font-family: monospace; 269 | cursor: pointer; 270 | } 271 | 272 | /* 工具提示样式 */ 273 | .tooltip { 274 | position: relative; 275 | display: inline-block; 276 | cursor: help; 277 | } 278 | 279 | .tooltip .tooltip-text { 280 | visibility: hidden; 281 | width: 200px; 282 | background-color: #555; 283 | color: #fff; 284 | text-align: center; 285 | border-radius: 6px; 286 | padding: 5px; 287 | position: absolute; 288 | z-index: 1; 289 | bottom: 125%; 290 | left: 50%; 291 | margin-left: -100px; 292 | opacity: 0; 293 | transition: opacity 0.3s; 294 | } 295 | 296 | .tooltip:hover .tooltip-text { 297 | visibility: visible; 298 | opacity: 1; 299 | } -------------------------------------------------------------------------------- /js/popup.js: -------------------------------------------------------------------------------- 1 | /** 2 | * Cron 解析器扩展的主要 JS 文件 3 | */ 4 | document.addEventListener('DOMContentLoaded', function () { 5 | // 初始化 Cron 解析器 6 | const parser = new CronParser() 7 | 8 | // 获取 DOM 元素 9 | const cronInput = document.getElementById('cron-input') 10 | const parseButton = document.getElementById('parse-button') 11 | const resultArea = document.getElementById('result-area') 12 | const formatSwitch = document.getElementById('format-switch') 13 | const formatLabel = document.getElementById('format-label') 14 | const tabs = document.querySelectorAll('.tab') 15 | const tabContents = document.querySelectorAll('.tab-content') 16 | const examplesList = document.getElementById('examples-list') 17 | const examplesListSix = document.getElementById('examples-list-six') 18 | const specialCharsList = document.getElementById('special-chars-list') 19 | 20 | // 示例数据 - 5 位格式 21 | const examples = [ 22 | { expression: '*/5 * * * *', description: '每5分钟执行一次' }, 23 | { expression: '0 * * * *', description: '每小时的第0分钟执行' }, 24 | { expression: '0 0 * * *', description: '每天午夜执行' }, 25 | { expression: '0 12 * * *', description: '每天中午12点执行' }, 26 | { expression: '0 0 * * 0', description: '每周日午夜执行' }, 27 | { expression: '0 0 1 * *', description: '每月1号午夜执行' }, 28 | { expression: '0 0 1 1 *', description: '每年1月1日午夜执行' }, 29 | { expression: '0 8-17 * * 1-5', description: '工作日的8点到17点整点执行' } 30 | ] 31 | 32 | // 示例数据 - 6 位格式 33 | const examplesSix = [ 34 | { expression: '0 */5 * * * *', description: '每5分钟执行一次' }, 35 | { expression: '0 0 * * * *', description: '每小时整点执行' }, 36 | { expression: '0 0 0 * * *', description: '每天午夜执行' }, 37 | { expression: '0 0 12 * * *', description: '每天中午12点执行' }, 38 | { expression: '*/10 * * * * *', description: '每10秒执行一次' }, 39 | { expression: '0 0 0 * * 0', description: '每周日午夜执行' }, 40 | { expression: '0 0 0 1 * *', description: '每月1号午夜执行' }, 41 | { expression: '0 0 0 1 1 *', description: '每年1月1日午夜执行' } 42 | ] 43 | 44 | // 特殊字符说明 45 | const specialChars = [ 46 | { char: '*', description: '表示所有可能的值' }, 47 | { char: ',', description: '用于列举值，如 "1,3,5"' }, 48 | { char: '-', description: '表示范围，如 "1-5"' }, 49 | { char: '/', description: '表示步长，如 "*/5" 表示每5个单位' }, 50 | { char: '?', description: '用于日期和星期字段，表示不指定值' } 51 | ] 52 | 53 | // 格式切换 54 | formatSwitch.addEventListener('change', function () { 55 | const is6Field = formatSwitch.checked 56 | formatLabel.textContent = is6Field ? '6位格式（秒分时日月周）' : '5位格式（分时日月周）' 57 | 58 | // 更新输入框占位符 59 | cronInput.placeholder = is6Field ? '例如: 0 */5 * * * *' : '例如: */5 * * * *' 60 | 61 | // 如果输入框不为空，尝试自动转换格式 62 | const expression = cronInput.value.trim() 63 | if (expression) { 64 | // 简单检测当前格式 65 | const parts = expression.split(/\s+/) 66 | 67 | if (is6Field && parts.length === 5) { 68 | // 从 5 位转换为 6 位，添加秒 "0" 69 | cronInput.value = `0 ${expression}` 70 | } else if (!is6Field && parts.length === 6) { 71 | // 从 6 位转换为 5 位，移除秒 72 | cronInput.value = parts.slice(1).join(' ') 73 | } 74 | } 75 | }) 76 | 77 | // 初始化示例列表 - 5 位格式 78 | examples.forEach(example => { 79 | const li = document.createElement('li') 80 | li.innerHTML = `${example.expression}: ${example.description}` 81 | li.addEventListener('click', () => { 82 | formatSwitch.checked = false 83 | formatLabel.textContent = '5位格式（分时日月周）' 84 | cronInput.placeholder = '例如: */5 * * * *' 85 | cronInput.value = example.expression 86 | parseCron() 87 | }) 88 | examplesList.appendChild(li) 89 | }) 90 | 91 | // 初始化示例列表 - 6 位格式 92 | examplesSix.forEach(example => { 93 | const li = document.createElement('li') 94 | li.innerHTML = `${example.expression}: ${example.description}` 95 | li.addEventListener('click', () => { 96 | formatSwitch.checked = true 97 | formatLabel.textContent = '6位格式（秒分时日月周）' 98 | cronInput.placeholder = '例如: 0 */5 * * * *' 99 | cronInput.value = example.expression 100 | parseCron() 101 | }) 102 | examplesListSix.appendChild(li) 103 | }) 104 | 105 | // 初始化特殊字符列表 106 | specialChars.forEach(item => { 107 | const li = document.createElement('li') 108 | li.innerHTML = `${item.char}: ${item.description}` 109 | specialCharsList.appendChild(li) 110 | }) 111 | 112 | // 选项卡切换 113 | tabs.forEach(tab => { 114 | tab.addEventListener('click', () => { 115 | // 移除所有选项卡的活动状态 116 | tabs.forEach(t => t.classList.remove('active')) 117 | tabContents.forEach(content => content.style.display = 'none') 118 | 119 | // 设置当前选项卡为活动状态 120 | tab.classList.add('active') 121 | const tabId = tab.getAttribute('data-tab') 122 | document.getElementById(tabId).style.display = 'block' 123 | }) 124 | }) 125 | 126 | // 设置默认选项卡 127 | tabs[0].click() 128 | 129 | // 输入框内容变化时实时解析 130 | cronInput.addEventListener('input', parseCron) 131 | 132 | // 解析 Cron 表达式 133 | function parseCron() { 134 | const expression = cronInput.value.trim() 135 | 136 | if (!expression) { 137 | resultArea.textContent = '请输入 Cron 表达式' 138 | resultArea.classList.add('error') 139 | return 140 | } 141 | 142 | const result = parser.parse(expression) 143 | 144 | if (result.error) { 145 | resultArea.textContent = `错误: ${result.error}` 146 | resultArea.classList.add('error') 147 | return 148 | } 149 | 150 | resultArea.classList.remove('error') 151 | 152 | // 构建结果文本 153 | let resultText = `格式: ${result.format === '6-field' ? '6位（秒分时日月周）' : '5位（分时日月周）'}\n` 154 | resultText += `${result.description}\n\n最近10次执行时间\n` 155 | 156 | result.nextDates.forEach((date, index) => { 157 | resultText += `第${index + 1}次: ${parser.formatDate(date, result.format === '6-field')}\n` 158 | }) 159 | 160 | resultArea.textContent = resultText 161 | } 162 | 163 | // 页面加载后立即解析一次 164 | parseCron() 165 | }) -------------------------------------------------------------------------------- /popup.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | Cron定时解析 8 | 9 | 10 | 11 | 12 |

13 | 28 | 29 |

30 |

31 |

32 | 表达式 33 | 34 |

35 |

36 |

37 |

38 |

39 | 40 |

41 |

42 |

例子

43 |

格式

44 |

特殊字符

45 |

46 | 47 |

48 |

49 |

5位格式（分时日月周）

50 |

51 | 52 |

6位格式（秒分时日月周）

53 |

54 |

55 | 56 |

57 |

5位格式（分时日月周）

58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 |

位置	字段	允许值	允许特殊字符
1	分钟	0-59	* , - /
2	小时	0-23	* , - /
3	日期	1-31	* , - / ?
4	月份	1-12	* , - /
5	星期	0-7 (0和7都表示周日)	* , - / ?

96 | 97 |

6位格式（秒分时日月周）

98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 |

位置	字段	允许值	允许特殊字符
1	秒	0-59	* , - /
2	分钟	0-59	* , - /
3	小时	0-23	* , - /
4	日期	1-31	* , - / ?
5	月份	1-12	* , - /
6	星期	0-7 (0和7都表示周日)	* , - / ?

142 |

143 | 144 |

145 |

特殊字符说明

146 |

147 |

148 |

149 |

150 |

151 |

152 | 153 | 154 | 155 | 156 | 157 | -------------------------------------------------------------------------------- /js/cron-parser.js: -------------------------------------------------------------------------------- 1 | /** 2 | * Cron 表达式解析器 3 | */ 4 | class CronParser { 5 | constructor() { 6 | // 支持 5 位和 6 位 Cron 表达式 7 | this.cronRegex5 = /^(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)$/ 8 | this.cronRegex6 = /^(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)$/ 9 | 10 | this.dayNames = { 11 | '0': '星期日', '1': '星期一', '2': '星期二', '3': '星期三', 12 | '4': '星期四', '5': '星期五', '6': '星期六', '7': '星期日', 13 | 'SUN': '星期日', 'MON': '星期一', 'TUE': '星期二', 'WED': '星期三', 14 | 'THU': '星期四', 'FRI': '星期五', 'SAT': '星期六' 15 | } 16 | this.monthNames = { 17 | '1': '1月', '2': '2月', '3': '3月', '4': '4月', '5': '5月', '6': '6月', 18 | '7': '7月', '8': '8月', '9': '9月', '10': '10月', '11': '11月', '12': '12月', 19 | 'JAN': '1月', 'FEB': '2月', 'MAR': '3月', 'APR': '4月', 'MAY': '5月', 'JUN': '6月', 20 | 'JUL': '7月', 'AUG': '8月', 'SEP': '9月', 'OCT': '10月', 'NOV': '11月', 'DEC': '12月' 21 | } 22 | } 23 | 24 | /** 25 | * 解析 Cron 表达式 26 | * @param {string} expression - Cron 表达式 27 | * @returns {object} 解析结果 28 | */ 29 | parse(expression) { 30 | // 移除多余的空格 31 | expression = expression.trim() 32 | 33 | let match 34 | let format = '5-field' // 默认为 5 位格式 35 | 36 | // 尝试匹配 6 位格式 37 | match = expression.match(this.cronRegex6) 38 | if (match) { 39 | format = '6-field' 40 | } else { 41 | // 尝试匹配 5 位格式 42 | match = expression.match(this.cronRegex5) 43 | if (!match) { 44 | return { error: "无效的 Cron 表达式格式。应为 '分时日月周' 或 '秒分时日月周'" } 45 | } 46 | } 47 | 48 | try { 49 | // 根据格式提取和解析字段 50 | if (format === '6-field') { 51 | // 6 位格式：秒、分、时、日、月、周 52 | const [_, second, minute, hour, dayOfMonth, month, dayOfWeek] = match 53 | 54 | const parsedSecond = this.parseField(second, 0, 59) 55 | const parsedMinute = this.parseField(minute, 0, 59) 56 | const parsedHour = this.parseField(hour, 0, 23) 57 | const parsedDayOfMonth = this.parseField(dayOfMonth, 1, 31) 58 | const parsedMonth = this.parseField(month, 1, 12) 59 | const parsedDayOfWeek = this.parseField(dayOfWeek, 0, 7) 60 | 61 | // 生成描述 62 | const description = this.generateDescription( 63 | parsedSecond, parsedMinute, parsedHour, parsedDayOfMonth, 64 | parsedMonth, parsedDayOfWeek, format 65 | ) 66 | 67 | // 生成未来执行时间 68 | const nextDates = this.generateNextDates( 69 | parsedSecond, parsedMinute, parsedHour, parsedDayOfMonth, 70 | parsedMonth, parsedDayOfWeek, format 71 | ) 72 | 73 | return { 74 | format, 75 | description, 76 | nextDates 77 | } 78 | } else { 79 | // 5 位格式：分、时、日、月、周 80 | const [_, minute, hour, dayOfMonth, month, dayOfWeek] = match 81 | 82 | const parsedMinute = this.parseField(minute, 0, 59) 83 | const parsedHour = this.parseField(hour, 0, 23) 84 | const parsedDayOfMonth = this.parseField(dayOfMonth, 1, 31) 85 | const parsedMonth = this.parseField(month, 1, 12) 86 | const parsedDayOfWeek = this.parseField(dayOfWeek, 0, 7) 87 | 88 | // 对于 5 位格式，秒始终为 0 89 | const parsedSecond = [0] 90 | 91 | // 生成描述 92 | const description = this.generateDescription( 93 | parsedSecond, parsedMinute, parsedHour, parsedDayOfMonth, 94 | parsedMonth, parsedDayOfWeek, format 95 | ) 96 | 97 | // 生成未来执行时间 98 | const nextDates = this.generateNextDates( 99 | parsedSecond, parsedMinute, parsedHour, parsedDayOfMonth, 100 | parsedMonth, parsedDayOfWeek, format 101 | ) 102 | 103 | return { 104 | format, 105 | description, 106 | nextDates 107 | } 108 | } 109 | } catch (error) { 110 | return { error: error.message } 111 | } 112 | } 113 | 114 | /** 115 | * 解析单个字段 116 | * @param {string} field - Cron 表达式的字段 117 | * @param {number} min - 最小有效值 118 | * @param {number} max - 最大有效值 119 | * @returns {Array} 解析后的值数组 120 | */ 121 | parseField(field, min, max) { 122 | // 处理特殊字符 123 | if (field === '*') { 124 | return Array.from({ length: max - min + 1 }, (_, i) => min + i) 125 | } 126 | 127 | const values = new Set() 128 | 129 | // 处理逗号分隔的列表 130 | field.split(',').forEach(part => { 131 | // 处理范围 (如 1-5) 132 | if (part.includes('-')) { 133 | const [start, end] = part.split('-').map(v => parseInt(v, 10)) 134 | if (isNaN(start) || isNaN(end) || start < min || end > max || start > end) { 135 | throw new Error(`无效的范围: ${part}`) 136 | } 137 | for (let i = start; i <= end; i++) { 138 | values.add(i) 139 | } 140 | } 141 | // 处理步长 (如 */5) 142 | else if (part.includes('/')) { 143 | const [range, step] = part.split('/') 144 | const stepInt = parseInt(step, 10) 145 | 146 | if (isNaN(stepInt) || stepInt <= 0) { 147 | throw new Error(`无效的步长: ${step}`) 148 | } 149 | 150 | let start = min 151 | let end = max 152 | 153 | if (range !== '*') { 154 | if (range.includes('-')) { 155 | [start, end] = range.split('-').map(v => parseInt(v, 10)) 156 | } else { 157 | start = parseInt(range, 10) 158 | if (isNaN(start)) { 159 | throw new Error(`无效的范围起点: ${range}`) 160 | } 161 | } 162 | } 163 | 164 | for (let i = start; i <= end; i += stepInt) { 165 | values.add(i) 166 | } 167 | } 168 | // 处理单个值 169 | else { 170 | const value = parseInt(part, 10) 171 | if (isNaN(value) || value < min || value > max) { 172 | throw new Error(`无效的值: ${part}`) 173 | } 174 | values.add(value) 175 | } 176 | }) 177 | 178 | return Array.from(values).sort((a, b) => a - b) 179 | } 180 | 181 | /** 182 | * 生成人类可读的描述 183 | */ 184 | generateDescription(seconds, minutes, hours, daysOfMonth, months, daysOfWeek, format) { 185 | let description = '' 186 | 187 | // 秒描述 (仅适用于 6 位格式) 188 | if (format === '6-field') { 189 | if (seconds.length === 60) { 190 | description += '每秒' 191 | } else if (seconds.length === 1) { 192 | description += `在第 ${seconds[0]} 秒` 193 | } else if (this.isEveryNth(seconds)) { 194 | const step = seconds[1] - seconds[0] 195 | description += `每隔 ${step} 秒` 196 | } else { 197 | description += `在第 ${seconds.join(', ')} 秒` 198 | } 199 | } 200 | 201 | // 分钟描述 202 | const minutePrefix = format === '6-field' ? '，' : '' 203 | if (minutes.length === 60) { 204 | description += `${minutePrefix}每分钟` 205 | } else if (minutes.length === 1) { 206 | description += `${minutePrefix}在第 ${minutes[0]} 分钟` 207 | } else if (this.isEveryNth(minutes)) { 208 | const step = minutes[1] - minutes[0] 209 | description += `${minutePrefix}每隔 ${step} 分钟` 210 | } else { 211 | description += `${minutePrefix}在第 ${minutes.join(', ')} 分钟` 212 | } 213 | 214 | // 小时描述 215 | if (hours.length === 24) { 216 | description += '的每小时' 217 | } else if (hours.length === 1) { 218 | description += `的 ${hours[0]} 点` 219 | } else if (this.isEveryNth(hours)) { 220 | const step = hours[1] - hours[0] 221 | description += `，每隔 ${step} 小时` 222 | } else { 223 | description += `的 ${hours.join(', ')} 点` 224 | } 225 | 226 | // 日期描述 227 | if (daysOfMonth.length === 31) { 228 | // 所有日期，看星期 229 | if (daysOfWeek.length === 7) { 230 | description += '，每天' 231 | } else if (daysOfWeek.length === 1) { 232 | description += `，每个${this.dayNames[daysOfWeek[0]]}` 233 | } else { 234 | const dayNames = daysOfWeek.map(d => this.dayNames[d]) 235 | description += `，每个${dayNames.join('、')}` 236 | } 237 | } else { 238 | description += `，每月的第 ${daysOfMonth.join(', ')} 日` 239 | 240 | if (daysOfWeek.length < 7) { 241 | const dayNames = daysOfWeek.map(d => this.dayNames[d]) 242 | description += `，如果是 ${dayNames.join('、')}` 243 | } 244 | } 245 | 246 | // 月份描述 247 | if (months.length === 12) { 248 | description += '' 249 | } else if (months.length === 1) { 250 | description += `，在 ${this.monthNames[months[0]]}` 251 | } else { 252 | const monthNames = months.map(m => this.monthNames[m]) 253 | description += `，在 ${monthNames.join('、')}` 254 | } 255 | 256 | return description 257 | } 258 | 259 | /** 260 | * 检查数组是否是等间隔的 261 | */ 262 | isEveryNth(arr) { 263 | if (arr.length <= 1) return false 264 | const step = arr[1] - arr[0] 265 | for (let i = 1; i < arr.length; i++) { 266 | if (arr[i] - arr[i - 1] !== step) { 267 | return false 268 | } 269 | } 270 | return true 271 | } 272 | 273 | /** 274 | * 生成未来的执行时间 275 | */ 276 | generateNextDates(seconds, minutes, hours, daysOfMonth, months, daysOfWeek, format) { 277 | const now = new Date() 278 | const result = [] 279 | let date = new Date(now) 280 | 281 | // 重置毫秒 282 | date.setMilliseconds(0) 283 | 284 | // 对于 5 位格式，秒设置为 0 285 | if (format === '5-field') { 286 | date.setSeconds(0) 287 | } 288 | 289 | // 找到10个未来的执行时间 290 | while (result.length < 10) { 291 | // 检查当前日期是否匹配 292 | if (this.dateMatches(date, seconds, minutes, hours, daysOfMonth, months, daysOfWeek)) { 293 | // 如果日期在未来，添加到结果 294 | if (date > now) { 295 | result.push(new Date(date)) 296 | } 297 | } 298 | 299 | // 根据格式前进不同的时间单位 300 | if (format === '6-field') { 301 | // 对于 6 位格式，前进一秒 302 | date.setSeconds(date.getSeconds() + 1) 303 | } else { 304 | // 对于 5 位格式，前进一分钟 305 | date.setMinutes(date.getMinutes() + 1) 306 | } 307 | } 308 | 309 | return result 310 | } 311 | 312 | /** 313 | * 检查日期是否匹配 Cron 表达式 314 | */ 315 | dateMatches(date, seconds, minutes, hours, daysOfMonth, months, daysOfWeek) { 316 | const second = date.getSeconds() 317 | const minute = date.getMinutes() 318 | const hour = date.getHours() 319 | const dayOfMonth = date.getDate() 320 | const month = date.getMonth() + 1 // JavaScript 月份从0开始 321 | const dayOfWeek = date.getDay() // JavaScript 星期从0(周日)开始 322 | 323 | return ( 324 | seconds.includes(second) && 325 | minutes.includes(minute) && 326 | hours.includes(hour) && 327 | daysOfMonth.includes(dayOfMonth) && 328 | months.includes(month) && 329 | (daysOfWeek.includes(dayOfWeek) || daysOfWeek.includes(7) && dayOfWeek === 0) 330 | ) 331 | } 332 | 333 | /** 334 | * 格式化日期为可读字符串 335 | */ 336 | formatDate(date, includeSeconds = true) { 337 | const pad = (num) => String(num).padStart(2, '0') 338 | 339 | const year = date.getFullYear() 340 | const month = pad(date.getMonth() + 1) 341 | const day = pad(date.getDate()) 342 | const hour = pad(date.getHours()) 343 | const minute = pad(date.getMinutes()) 344 | const second = pad(date.getSeconds()) 345 | 346 | return includeSeconds 347 | ? `${year}-${month}-${day} ${hour}:${minute}:${second}` 348 | : `${year}-${month}-${day} ${hour}:${minute}:00` 349 | } 350 | } 351 | 352 | // 导出解析器 353 | window.CronParser = CronParser --------------------------------------------------------------------------------

Cron定时解析

5位格式（分 时 日 月 周）

6位格式（秒 分 时 日 月 周）

5位格式（分 时 日 月 周）

6位格式（秒 分 时 日 月 周）

特殊字符说明

5位格式（分时日月周）

6位格式（秒分时日月周）

5位格式（分时日月周）

6位格式（秒分时日月周）