DocsCron Expression

Cron Expression Guide

Cron expressions are powerful patterns that define recurring schedules for your jobs. They consist of five or six fields that specify when a task should run, allowing for flexible scheduling from minutes to specific months and days.

Basic Format

A cron expression follows this format:

Visual representation of cron format
minute (0 - 59)
Visual representation of cron format
hour (0 - 23)
Visual representation of cron format
day of month (1 - 31)
Visual representation of cron format
month (1 - 12)
Visual representation of cron format
day of week (0 - 6)
* * * * *

Common Patterns

Here are some frequently used cron patterns:

  • * * * * * - Every minute
  • 0 * * * * - Every hour (at minute 0)
  • 0 0 * * * - Every day at midnight
  • 0 9 * * 1-5 - Every weekday at 9 AM
  • 0 0 1 * * - First day of every month at midnight
  • */15 * * * * - Every 15 minutes

Special Characters

  • * - Any value
  • , - Value list separator (e.g., 1,3,5)
  • - - Range of values (e.g., 1-5)
  • / - Step values (e.g., */15)

Examples Explained

# Run at 10:30 AM every day
30 10 * * *

# Run at 2:00 PM and 8:00 PM every day
0 14,20 * * *

# Run every 30 minutes
*/30 * * * *

# Run at midnight on Mondays
0 0 * * 1

# Run at 9:00 AM on weekdays
0 9 * * 1-5
Local DevelopmentNext.js