Programming · Tool

Cron Expression Builder

Build a cron expression part-by-part, get a plain-English description, and preview the next five scheduled runs in your timezone. Handles ranges, lists, step values, and named days.

EndpointPOST /v1/programming-dev/cron-expression-builderVersionv1.0.0Added2026-05-17

Inputs

minutestringMinute
default "0"
When in the hour. * = every minute. 0 = top of the hour. */15 = every 15 minutes. 0,30 = on the hour and half past.
hourstringHour
default "9"
Which hour(s), 24-hour clock. 9-17 = 9 AM to 5 PM. * = every hour.
day_of_monthstringDay of Month
default "*"
1-31. * = every day. 1,15 = first and fifteenth. Combine with Day of Week for finer control.
monthstringMonth
default "*"
1-12 or JAN-DEC. * = every month.
day_of_weekstringDay of Week
default "1-5"
0=Sunday, 6=Saturday. 1-5 = Mon–Fri. Names like MON-FRI also work.
timezoneenumTimezone
default "Asia/Kolkata" · one of: UTC, Asia/Kolkata, Asia/Tokyo, Asia/Singapore, Asia/Dubai, Europe/London, Europe/Berlin, America/New_York, America/Chicago, America/Los_Angeles, Australia/Sydney
Cron expressions are timezone-agnostic by themselves — the timezone tells us when to fire in real time. Pick where your servers actually run.

Outputs

expressionstringCron Expression
human_readablestringPlain English
next_runs_prettystringNext 5 Runs
next_run_isostringNext Run (ISO 8601)
interval_summarystringFires Approximately
validbooleanParses Cleanly

Example request

curl -X POST https://toolsamurai.com/api/v1/programming-dev/cron-expression-builder \
  -H "Authorization: Bearer sk_free_•••••••••••••••" \
  -H "Content-Type: application/json" \
  -d '{
       "minute": "0",
       "hour": "9",
       "day_of_month": "*",
       "month": "*",
       "day_of_week": "1-5",
       "timezone": "Asia/Kolkata"
     }'

Example response

200 OK
{
  "ok": true,
  "tool": "cron-expression-builder",
  "domain": "programming-dev",
  "version": "1.0.0",
  "result": {
    "expression": "…",
    "human_readable": "…",
    "next_runs_pretty": "…",
    "next_run_iso": "…",
    "interval_summary": "…",
    "valid": true
  },
  "meta": { "latency_ms": , "request_id": "req_…" }
}

Tags

cronschedulercronjobautomationtimezonedevops