From a1d7e81859f554f3a53680cc35f0f49bf1f77098 Mon Sep 17 00:00:00 2001
From: wwf <1971391498@qq.com>
Date: 星期四, 14 五月 2026 14:37:02 +0800
Subject: [PATCH] 导入项目
---
src/utils/cron.ts | 471 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 471 insertions(+), 0 deletions(-)
diff --git a/src/utils/cron.ts b/src/utils/cron.ts
new file mode 100644
index 0000000..ee132f0
--- /dev/null
+++ b/src/utils/cron.ts
@@ -0,0 +1,471 @@
+/**
+ * CRON 琛ㄨ揪寮忓伐鍏风被
+ * 鎻愪緵 CRON 琛ㄨ揪寮忕殑瑙ｆ瀽銆佹牸寮忓寲銆侀獙璇佺瓑鍔熻兘
+ */
+
+/** CRON 瀛楁绫诲瀷鏋氫妇 */
+export enum CronFieldType {
+ SECOND = 'second',
+ MINUTE = 'minute',
+ HOUR = 'hour',
+ DAY = 'day',
+ MONTH = 'month',
+ WEEK = 'week',
+ YEAR = 'year'
+}
+
+/** CRON 瀛楁閰嶇疆 */
+export interface CronFieldConfig {
+ key: CronFieldType
+ label: string
+ min: number
+ max: number
+ names?: Record<string, number> // 鍚嶇О鏄犲皠锛屽鏈堜唤鍚嶇О
+}
+
+/** CRON 瀛楁閰嶇疆甯搁噺 */
+export const CRON_FIELD_CONFIGS: Record<CronFieldType, CronFieldConfig> = {
+ [CronFieldType.SECOND]: { key: CronFieldType.SECOND, label: '绉�', min: 0, max: 59 },
+ [CronFieldType.MINUTE]: { key: CronFieldType.MINUTE, label: '鍒�', min: 0, max: 59 },
+ [CronFieldType.HOUR]: { key: CronFieldType.HOUR, label: '鏃�', min: 0, max: 23 },
+ [CronFieldType.DAY]: { key: CronFieldType.DAY, label: '鏃�', min: 1, max: 31 },
+ [CronFieldType.MONTH]: {
+ key: CronFieldType.MONTH,
+ label: '鏈�',
+ min: 1,
+ max: 12,
+ names: {
+ JAN: 1,
+ FEB: 2,
+ MAR: 3,
+ APR: 4,
+ MAY: 5,
+ JUN: 6,
+ JUL: 7,
+ AUG: 8,
+ SEP: 9,
+ OCT: 10,
+ NOV: 11,
+ DEC: 12
+ }
+ },
+ [CronFieldType.WEEK]: {
+ key: CronFieldType.WEEK,
+ label: '鍛�',
+ min: 0,
+ max: 7,
+ names: {
+ SUN: 0,
+ MON: 1,
+ TUE: 2,
+ WED: 3,
+ THU: 4,
+ FRI: 5,
+ SAT: 6
+ }
+ },
+ [CronFieldType.YEAR]: { key: CronFieldType.YEAR, label: '骞�', min: 1970, max: 2099 }
+}
+
+/** 瑙ｆ瀽鍚庣殑 CRON 瀛楁 */
+export interface ParsedCronField {
+ type: 'any' | 'specific' | 'range' | 'step' | 'list' | 'last' | 'weekday' | 'nth'
+ values: number[]
+ original: string
+ description: string
+}
+
+/** 瑙ｆ瀽鍚庣殑 CRON 琛ㄨ揪寮� */
+export interface ParsedCronExpression {
+ second: ParsedCronField
+ minute: ParsedCronField
+ hour: ParsedCronField
+ day: ParsedCronField
+ month: ParsedCronField
+ week: ParsedCronField
+ year?: ParsedCronField
+ isValid: boolean
+ description: string
+ nextExecutionTime?: Date
+}
+
+/** 甯哥敤 CRON 琛ㄨ揪寮忛璁� */
+export const CRON_PRESETS = {
+ EVERY_SECOND: '* * * * * ?',
+ EVERY_MINUTE: '0 * * * * ?',
+ EVERY_HOUR: '0 0 * * * ?',
+ EVERY_DAY: '0 0 0 * * ?',
+ EVERY_WEEK: '0 0 0 ? * 1',
+ EVERY_MONTH: '0 0 0 1 * ?',
+ EVERY_YEAR: '0 0 0 1 1 ?',
+ WORKDAY_9AM: '0 0 9 ? * 2-6', // 宸ヤ綔鏃ヤ笂鍗�9鐐�
+ WORKDAY_6PM: '0 0 18 ? * 2-6', // 宸ヤ綔鏃ヤ笅鍗�6鐐�
+ WEEKEND_10AM: '0 0 10 ? * 1,7' // 鍛ㄦ湯涓婂崍10鐐�
+} as const
+
+/** CRON 琛ㄨ揪寮忓伐鍏风被 */
+export class CronUtils {
+ /** 楠岃瘉 CRON 琛ㄨ揪寮忔牸寮� */
+ static validate(cronExpression: string): boolean {
+ if (!cronExpression || typeof cronExpression !== 'string') {
+ return false
+ }
+
+ const parts = cronExpression.trim().split(/\s+/)
+
+ // 鏀寔 5-7 涓瓧娈电殑 CRON 琛ㄨ揪寮�
+ if (parts.length < 5 || parts.length > 7) {
+ return false
+ }
+
+ // 鍩烘湰鏍煎紡楠岃瘉
+ const cronRegex = /^[0-9*\/\-,?LW#]+$/
+ return parts.every((part) => cronRegex.test(part))
+ }
+
+ /** 瑙ｆ瀽鍗曚釜 CRON 瀛楁 */
+ static parseField(
+ fieldValue: string,
+ fieldType: CronFieldType,
+ config: CronFieldConfig
+ ): ParsedCronField {
+ const field: ParsedCronField = {
+ type: 'any',
+ values: [],
+ original: fieldValue,
+ description: ''
+ }
+
+ // 澶勭悊鐗规畩瀛楃
+ if (fieldValue === '*' || fieldValue === '?') {
+ field.type = 'any'
+ field.description = `姣�${config.label}`
+ return field
+ }
+
+ // 澶勭悊鏈�鍚庝竴澶� (L)
+ if (fieldValue === 'L' && fieldType === CronFieldType.DAY) {
+ field.type = 'last'
+ field.description = '姣忔湀鏈�鍚庝竴澶�'
+ return field
+ }
+
+ // 澶勭悊鑼冨洿 (-)
+ if (fieldValue.includes('-')) {
+ const [start, end] = fieldValue.split('-').map(Number)
+ if (!isNaN(start) && !isNaN(end) && start >= config.min && end <= config.max) {
+ field.type = 'range'
+ field.values = Array.from({ length: end - start + 1 }, (_, i) => start + i)
+ field.description = `${config.label} ${start}-${end}`
+ }
+ return field
+ }
+
+ // 澶勭悊姝ラ暱 (/)
+ if (fieldValue.includes('/')) {
+ const [base, step] = fieldValue.split('/')
+ const stepNum = Number(step)
+ if (!isNaN(stepNum) && stepNum > 0) {
+ field.type = 'step'
+ if (base === '*') {
+ field.description = `姣�${stepNum}${config.label}`
+ } else {
+ const startNum = Number(base)
+ field.description = `浠�${startNum}寮�濮嬫瘡${stepNum}${config.label}`
+ }
+ }
+ return field
+ }
+
+ // 澶勭悊鍒楄〃 (,)
+ if (fieldValue.includes(',')) {
+ const values = fieldValue
+ .split(',')
+ .map(Number)
+ .filter((n) => !isNaN(n))
+ if (values.length > 0) {
+ field.type = 'list'
+ field.values = values
+ field.description = `${config.label} ${values.join(',')}`
+ }
+ return field
+ }
+
+ // 澶勭悊鍏蜂綋鏁板��
+ const numValue = Number(fieldValue)
+ if (!isNaN(numValue) && numValue >= config.min && numValue <= config.max) {
+ field.type = 'specific'
+ field.values = [numValue]
+ field.description = `${config.label} ${numValue}`
+ }
+
+ return field
+ }
+
+ /** 瑙ｆ瀽瀹屾暣鐨� CRON 琛ㄨ揪寮� */
+ static parse(cronExpression: string): ParsedCronExpression {
+ const result: ParsedCronExpression = {
+ second: { type: 'any', values: [], original: '*', description: '姣忕' },
+ minute: { type: 'any', values: [], original: '*', description: '姣忓垎' },
+ hour: { type: 'any', values: [], original: '*', description: '姣忔椂' },
+ day: { type: 'any', values: [], original: '*', description: '姣忔棩' },
+ month: { type: 'any', values: [], original: '*', description: '姣忔湀' },
+ week: { type: 'any', values: [], original: '?', description: '浠绘剰鍛�' },
+ isValid: false,
+ description: ''
+ }
+
+ if (!this.validate(cronExpression)) {
+ result.description = '鏃犳晥鐨� CRON 琛ㄨ揪寮�'
+ return result
+ }
+
+ const parts = cronExpression.trim().split(/\s+/)
+ const fieldTypes = [
+ CronFieldType.SECOND,
+ CronFieldType.MINUTE,
+ CronFieldType.HOUR,
+ CronFieldType.DAY,
+ CronFieldType.MONTH,
+ CronFieldType.WEEK
+ ]
+
+ // 濡傛灉鍙湁5涓瓧娈碉紝鍒欑涓�涓瓧娈垫槸鍒嗛挓
+ const startIndex = parts.length === 5 ? 1 : 0
+
+ for (let i = 0; i < parts.length; i++) {
+ const fieldType = fieldTypes[i + startIndex]
+ if (fieldType && CRON_FIELD_CONFIGS[fieldType]) {
+ const config = CRON_FIELD_CONFIGS[fieldType]
+ result[fieldType] = this.parseField(parts[i], fieldType, config)
+ }
+ }
+
+ // 澶勭悊骞翠唤瀛楁锛堝鏋滃瓨鍦級
+ if (parts.length === 7) {
+ const yearConfig = CRON_FIELD_CONFIGS[CronFieldType.YEAR]
+ result.year = this.parseField(parts[6], CronFieldType.YEAR, yearConfig)
+ }
+
+ result.isValid = true
+ result.description = this.generateDescription(result)
+
+ return result
+ }
+
+ /** 鐢熸垚 CRON 琛ㄨ揪寮忕殑鍙鎻忚堪 */
+ static generateDescription(parsed: ParsedCronExpression): string {
+ const parts: string[] = []
+
+ // 鏋勫缓鏃堕棿閮ㄥ垎鎻忚堪
+ if (parsed.hour.type === 'specific' && parsed.minute.type === 'specific') {
+ const hour = parsed.hour.values[0]
+ const minute = parsed.minute.values[0]
+ parts.push(`${hour.toString().padStart(2, '0')}:${minute.toString().padStart(2, '0')}`)
+ } else if (parsed.hour.type === 'specific') {
+ parts.push(`姣忓ぉ${parsed.hour.values[0]}鐐筦)
+ } else if (parsed.minute.type === 'specific' && parsed.minute.values[0] === 0) {
+ if (parsed.hour.type === 'any') {
+ parts.push('姣忓皬鏃舵暣鐐�')
+ }
+ } else if (parsed.minute.type === 'step') {
+ const step = parsed.minute.original.split('/')[1]
+ parts.push(`姣�${step}鍒嗛挓`)
+ } else if (parsed.hour.type === 'step') {
+ const step = parsed.hour.original.split('/')[1]
+ parts.push(`姣�${step}灏忔椂`)
+ }
+
+ // 鏋勫缓鏃ユ湡閮ㄥ垎鎻忚堪
+ if (parsed.day.type === 'specific') {
+ parts.push(`姣忔湀${parsed.day.values[0]}鏃)
+ } else if (parsed.week.type === 'specific') {
+ const weekNames = ['鍛ㄦ棩', '鍛ㄤ竴', '鍛ㄤ簩', '鍛ㄤ笁', '鍛ㄥ洓', '鍛ㄤ簲', '鍛ㄥ叚']
+ const weekDay = parsed.week.values[0]
+ if (weekDay >= 0 && weekDay <= 6) {
+ parts.push(`姣�${weekNames[weekDay]}`)
+ }
+ } else if (parsed.week.type === 'range') {
+ parts.push('宸ヤ綔鏃�')
+ }
+
+ // 鏋勫缓鏈堜唤閮ㄥ垎鎻忚堪
+ if (parsed.month.type === 'specific') {
+ parts.push(`${parsed.month.values[0]}鏈坄)
+ }
+
+ return parts.length > 0 ? parts.join(' ') : '鑷畾涔夋椂闂磋鍒�'
+ }
+
+ /** 鏍煎紡鍖� CRON 琛ㄨ揪寮忎负鍙鏂囨湰 */
+ static format(cronExpression: string): string {
+ if (!cronExpression) return ''
+
+ const parsed = this.parse(cronExpression)
+ return parsed.isValid ? parsed.description : cronExpression
+ }
+
+ /** 鑾峰彇棰勮鐨� CRON 琛ㄨ揪寮忓垪琛� */
+ static getPresets() {
+ return Object.entries(CRON_PRESETS).map(([key, value]) => ({
+ label: this.format(value),
+ value,
+ key
+ }))
+ }
+
+ /** 璁＄畻 CRON 琛ㄨ揪寮忕殑涓嬫鎵ц鏃堕棿 */
+ static getNextExecutionTime(cronExpression: string, fromDate?: Date): Date | null {
+ const parsed = this.parse(cronExpression)
+ if (!parsed.isValid) {
+ return null
+ }
+
+ const now = fromDate || new Date()
+ // eslint-disable-next-line prefer-const
+ let nextTime = new Date(now.getTime() + 1000) // 浠庝笅涓�绉掑紑濮�
+
+ // 绠�鍖栫増鏈細澶勭悊甯歌鐨� CRON 琛ㄨ揪寮忔ā寮�
+ // 瀵逛簬澶嶆潅鐨� CRON 琛ㄨ揪寮忥紝寤鸿浣跨敤涓撻棬鐨勫簱濡� node-cron 鎴� cron-parser
+
+ // 澶勭悊姣忓垎閽熸墽琛�
+ if (parsed.second.type === 'specific' && parsed.minute.type === 'any') {
+ const targetSecond = parsed.second.values[0]
+ nextTime.setSeconds(targetSecond, 0)
+ if (nextTime <= now) {
+ nextTime.setMinutes(nextTime.getMinutes() + 1)
+ }
+ return nextTime
+ }
+
+ // 澶勭悊姣忓皬鏃舵墽琛�
+ if (
+ parsed.second.type === 'specific' &&
+ parsed.minute.type === 'specific' &&
+ parsed.hour.type === 'any'
+ ) {
+ const targetSecond = parsed.second.values[0]
+ const targetMinute = parsed.minute.values[0]
+ nextTime.setMinutes(targetMinute, targetSecond, 0)
+ if (nextTime <= now) {
+ nextTime.setHours(nextTime.getHours() + 1)
+ }
+ return nextTime
+ }
+
+ // 澶勭悊姣忓ぉ鎵ц
+ if (
+ parsed.second.type === 'specific' &&
+ parsed.minute.type === 'specific' &&
+ parsed.hour.type === 'specific'
+ ) {
+ const targetSecond = parsed.second.values[0]
+ const targetMinute = parsed.minute.values[0]
+ const targetHour = parsed.hour.values[0]
+
+ nextTime.setHours(targetHour, targetMinute, targetSecond, 0)
+ if (nextTime <= now) {
+ nextTime.setDate(nextTime.getDate() + 1)
+ }
+ return nextTime
+ }
+
+ // 澶勭悊姝ラ暱鎵ц
+ if (parsed.minute.type === 'step') {
+ const step = parseInt(parsed.minute.original.split('/')[1])
+ const currentMinute = nextTime.getMinutes()
+ const nextMinute = Math.ceil(currentMinute / step) * step
+
+ if (nextMinute >= 60) {
+ nextTime.setHours(nextTime.getHours() + 1, 0, 0, 0)
+ } else {
+ nextTime.setMinutes(nextMinute, 0, 0)
+ }
+ return nextTime
+ }
+
+ // 瀵逛簬鍏朵粬澶嶆潅鎯呭喌锛岃繑鍥炰竴涓及绠楁椂闂�
+ return new Date(now.getTime() + 60000) // 1鍒嗛挓鍚�
+ }
+
+ /** 鑾峰彇 CRON 琛ㄨ揪寮忕殑鎵ц棰戠巼鎻忚堪 */
+ static getFrequencyDescription(cronExpression: string): string {
+ const parsed = this.parse(cronExpression)
+ if (!parsed.isValid) {
+ return '鏃犳晥琛ㄨ揪寮�'
+ }
+
+ // 璁＄畻澶ф鐨勬墽琛岄鐜�
+ if (parsed.second.type === 'any' && parsed.minute.type === 'any') {
+ return '姣忕鎵ц'
+ }
+
+ if (parsed.minute.type === 'any' && parsed.hour.type === 'any') {
+ return '姣忓垎閽熸墽琛�'
+ }
+
+ if (parsed.hour.type === 'any' && parsed.day.type === 'any') {
+ return '姣忓皬鏃舵墽琛�'
+ }
+
+ if (parsed.day.type === 'any' && parsed.month.type === 'any') {
+ return '姣忓ぉ鎵ц'
+ }
+
+ if (parsed.month.type === 'any') {
+ return '姣忔湀鎵ц'
+ }
+
+ return '鎸夎鍒掓墽琛�'
+ }
+
+ /** 妫�鏌� CRON 琛ㄨ揪寮忔槸鍚︿細鍦ㄦ寚瀹氭椂闂存墽琛� */
+ static willExecuteAt(cronExpression: string, targetDate: Date): boolean {
+ const parsed = this.parse(cronExpression)
+ if (!parsed.isValid) {
+ return false
+ }
+
+ // 妫�鏌ュ悇涓瓧娈垫槸鍚﹀尮閰�
+ const second = targetDate.getSeconds()
+ const minute = targetDate.getMinutes()
+ const hour = targetDate.getHours()
+ const day = targetDate.getDate()
+ const month = targetDate.getMonth() + 1
+ const weekDay = targetDate.getDay()
+
+ return (
+ this.fieldMatches(parsed.second, second) &&
+ this.fieldMatches(parsed.minute, minute) &&
+ this.fieldMatches(parsed.hour, hour) &&
+ this.fieldMatches(parsed.day, day) &&
+ this.fieldMatches(parsed.month, month) &&
+ (parsed.week.type === 'any' || this.fieldMatches(parsed.week, weekDay))
+ )
+ }
+
+ /** 妫�鏌ュ瓧娈靛�兼槸鍚﹀尮閰� */
+ private static fieldMatches(field: ParsedCronField, value: number): boolean {
+ if (field.type === 'any') {
+ return true
+ }
+
+ if (field.type === 'specific' || field.type === 'list') {
+ return field.values.includes(value)
+ }
+
+ if (field.type === 'range') {
+ return value >= field.values[0] && value <= field.values[field.values.length - 1]
+ }
+
+ if (field.type === 'step') {
+ const [base, step] = field.original.split('/').map(Number)
+ if (base === 0 || field.original.startsWith('*')) {
+ return value % step === 0
+ }
+ return value >= base && (value - base) % step === 0
+ }
+
+ return false
+ }
+}
--
Gitblit v1.8.0