Function match

repos/effect/packages/effect/src/Cron.ts:660–694

(cron: Cron, date: DateTime.DateTime.Input)

  const segments: Array<string> = []
  let index = 0
  while (index < array.length) {
    const start = array[index]!
    const step = array[index + 1]! - start
    if (index + 2 < array.length && array[index + 2]! - array[index + 1]! === step) {
      let end = index + 2
      while (end + 1 < array.length && array[end + 1]! - array[end]! === step) {
        end++
      }
      segments.push(`${start}-${array[end]}${step === 1 ? "" : `/${step}`}`)
      index = end + 1
    } else {
      segments.push(`${start}`)
      index++
    }
  }
  return segments.join(",")
}

/**
 * Returns `true` when a date/time matches a `Cron` schedule.
 *
 * **When to use**
 *
 * Use to test whether a specific date/time satisfies a cron schedule.
 *
 * **Details**
 *
 * The schedule's timezone determines which calendar fields are read from the
 * input; the host system's timezone is used when the schedule has no timezone.
 * Seconds, minutes, hours, and months are checked against their restrictions;
 * an empty set leaves that field unrestricted. If only `days` or `weekdays` is
 * restricted, that field must match. If both are restricted, either may match
 * unless the schedule was created with `and: true`, which requires both to
 * match.
 *
 * **Example** (Matching dates against a schedule)
 *
 * ```ts import.meta.vitest