cron 式パーサー

1. プリセットボタンをクリックするか、cron式を直接入力してください
2. 5つのフィールド（分・時・日・月・曜日）に分解して表示します
3. 「意味」欄に日本語での説明が表示されます
4. 「次回実行時刻」に現在時刻以降の5件が表示されます

外部ライブラリ不要でそのままコピーして利用できます。matchesField 関数が各フィールドのマッチ判定ロジックです。

export type CronFields = {
  minute: string
  hour: string
  dayOfMonth: string
  month: string
  dayOfWeek: string
}

export type ParseResult =
  | { ok: true; fields: CronFields; description: string }
  | { ok: false; error: string }

// フィールド値に対して指定した数値がマッチするか判定
function matchesField(value: string, num: number): boolean {
  if (value === '*') return true
  if (value.includes(','))
    return value.split(',').some(part => matchesField(part.trim(), num))
  if (/^\*\/(\d+)$/.test(value)) {
    const n = parseInt(value.slice(2), 10)
    return n > 0 && num % n === 0
  }
  const rangeStep = value.match(/^(\d+)-(\d+)\/(\d+)$/)
  if (rangeStep) {
    const [, a, b, n] = rangeStep.map(Number)
    return num >= a && num <= b && n > 0 && (num - a) % n === 0
  }
  const range = value.match(/^(\d+)-(\d+)$/)
  if (range) return num >= Number(range[1]) && num <= Number(range[2])
  if (/^\d+$/.test(value)) return parseInt(value, 10) === num
  return false
}

// cron式をパース
export function parseCron(expr: string): ParseResult {
  const parts = expr.trim().split(/\s+/)
  if (parts.length !== 5)
    return { ok: false, error: '5フィールド（分 時 日 月 曜日）が必要です' }
  const valid = /^[*0-9,\-/]+$/
  if (!parts.every(p => valid.test(p)))
    return { ok: false, error: '無効な文字が含まれています' }
  const fields: CronFields = {
    minute: parts[0], hour: parts[1],
    dayOfMonth: parts[2], month: parts[3], dayOfWeek: parts[4],
  }
  return { ok: true, fields, description: describeCron(fields) }
}

// 次のN回の実行時刻を返す
export function getNextExecutions(fields: CronFields, count: number, from?: Date): Date[] {
  const cur = from ? new Date(from) : new Date()
  cur.setSeconds(0, 0)
  cur.setMinutes(cur.getMinutes() + 1)
  const results: Date[] = []
  for (let i = 0; i < 500_000 && results.length < count; i++) {
    if (
      matchesField(fields.minute, cur.getMinutes()) &&
      matchesField(fields.hour, cur.getHours()) &&
      matchesField(fields.dayOfMonth, cur.getDate()) &&
      matchesField(fields.month, cur.getMonth() + 1) &&
      matchesField(fields.dayOfWeek, cur.getDay())
    ) results.push(new Date(cur))
    cur.setMinutes(cur.getMinutes() + 1)
  }
  return results
}

このツールのソースコード（テストコードを含む）はGitHubで公開しています。 MITライセンスで自由に利用・改変できます。