Introducing shieldcn — README badges, shadcn style.

Check it out

Cron Schedule

Visual cron expression display with field breakdown, human-readable summary, and next-run preview.

Loading...

Installation

$ shadcn add @jalco/cron-schedule

Usage

import { CronSchedule } from "@/components/cron-schedule"
<CronSchedule expression="0 9 * * 1-5" title="Daily Standup" />

Examples

Common schedules

Every 15 minutes

Health Check

Every 15 minutes

*/15 * * * *
Minute*/15every 15
Hour*every
Day (Month)*every
Month*every
Day (Week)*every

Weekdays at 9 AM

Daily Standup

At 9:00 AM, Mon through Fri

0 9 * * 1-5
Minute00
Hour99
Day (Month)*every
Month*every
Day (Week)1-5Mon, Tue, Wed, Thu, Fri

Next runs

Show upcoming execution times based on the cron expression.

Next 3 runs

Monthly Report

At 12:00 AM, on day 1 of the month

0 0 1 * *
Minute00
Hour00
Day (Month)11
Month*every
Day (Week)*every

Next 3 runs

  1. 1Fri, May 1 at 12:00 AM
  2. 2Mon, Jun 1 at 12:00 AM
  3. 3Wed, Jul 1 at 12:00 AM

API Reference

CronSchedule

PropType

Notes

  • Server component. No "use client" — renders entirely on the server with zero client JS.
  • No dependencies. Cron parsing and next-run computation are built-in. No external scheduling library required.
  • Timezone. Next-run times use the server's local timezone (or the timezone of the provided referenceDate ). No timezone conversion is applied.