What Kinds of Schedule Descriptions Can You Enter Into CronAI?
Updated
CronAI accepts plain-English scheduling phrases and converts them into standard 5-field cron syntax. According to the site, it handles four main categories: time-of-day schedules, interval schedules, calendar-based schedules, and multiple daily times. You type a description like "Every weekday at 9am," and the tool generates the matching cron expression for systems such as Linux crontab, GitHub Actions, AWS CloudWatch, Kubernetes CronJobs, and Vercel Cron.
The Four Schedule Types CronAI Handles
Time-of-day schedules
These describe a specific clock time on specific days. The site's own examples include:
- "Every weekday at 9am"
- "Every Sunday at 3:30pm"
This category covers the most common cron use cases: daily jobs at a fixed hour, weekly jobs on a named day, and weekday-only runs.
Interval schedules
These describe how often something repeats rather than when on the clock. Examples from the site:
- "Every 5 minutes"
- "Every hour during business hours"
Interval phrasing is useful for polling jobs, health checks, and recurring syncs. Note that "during business hours" is a bounded interval, so expect the generated expression to reflect a specific hour range rather than a single repeating step.
Calendar-based schedules
These anchor to a date position in the month or year. Example:
- "First day of every month at midnight"
This is the pattern for monthly reports, billing runs, and cleanup jobs. Phrase the day position explicitly ("first day," "last day," a specific date) so the conversion has an unambiguous target.
Multiple daily times
These combine two or more clock times in one schedule. Example:
- "Twice a day at 6am and 6pm"
Cron's 5-field syntax expresses this as two hour values in the hour field, so a plain-English phrase with both times maps cleanly.
How to Phrase a Description That Converts Well
The generator works from natural language, so clarity matters more than syntax. A few habits improve results:
- Name the day or day pattern. Say "every weekday," "every Sunday," or "first day of every month" rather than "regularly" or "often."
- Give exact times with am/pm. "At 9am" and "at 3:30pm" are unambiguous; "in the morning" is not.
- State the interval unit. "Every 5 minutes" and "every hour" convert directly; "frequently" does not.
- Put multiple times in one sentence. "At 6am and 6pm" signals a two-value hour field.
Verifying the Output
After you enter a description, read the generated 5-field expression field by field — minute, hour, day of month, month, day of week — and confirm each matches your intent. Two checks catch most mistakes:
- Day-of-week vs. day-of-month: confirm which field carries your day constraint, since mixing both can produce unexpected run dates.
- Interval boundaries: for phrases like "during business hours," confirm the start and end hours in the expression match your working day.
Then test the expression in the target system's own scheduler preview or a dry run before relying on it in production.
What the Site Does Not Specify
The page evidence does not state limits on phrase complexity, supported languages, or whether ambiguous descriptions trigger a clarification step. If your schedule is unusual — for example, "every second Tuesday" or "last Friday of the quarter" — check the generated expression carefully against a calendar, since these patterns are easy to misread in cron syntax.
Quick Reference
| Description type | Example phrase | Typical cron shape |
|---|---|---|
| Time of day | Every weekday at 9am | Fixed minute and hour, weekday range |
| Interval | Every 5 minutes | Step value in minute field |
| Calendar-based | First day of every month at midnight | Day-of-month set to 1, hour 0 |
| Multiple daily times | Twice a day at 6am and 6pm | Two values in hour field |
If your phrase fits one of these four patterns, CronAI should produce a usable expression; if it does not, simplify the description into one of these shapes before converting.