What Is Cron? A Practical Guide to This Time Language from Zero to Useful

What Is Cron? A Practical Guide to This Time Language

"Clean the database every day at 2 AM", "sync the cache every 15 minutes", "send a report every Monday at 8 AM" - behind all of these automation tasks there is one quiet but powerful piece: Cron.

1. What is Cron?

Cron is an expression language used to describe when a task should run. It does not execute the task itself. It only defines the schedule, and a scheduler triggers your code when the expression matches.

You can think of it as a DSL for time.

2. Why should you understand Cron?

• Scheduled cleanup, data archiving, report generation, cache refreshes, and external sync jobs all rely on it.
• Modern frameworks such as NestJS, Spring, and Django, along with cloud platforms like Kubernetes and Serverless systems, commonly support Cron.

In NestJS, one line is enough to define a scheduled task:

import { Cron } from '@nestjs/schedule';

@Cron('0 0 2 * * *', { timeZone: 'UTC' })
handleCron() {
  console.log('Runs every day at 2 AM');
}

3. The two common Cron formats

1) Standard Unix format (5 fields)

minute hour day month weekday

Example:

0 2 * * *

Meaning: run every day at 02

2) Extended format (6 fields, used by NestJS)

second minute hour day month weekday

Example:

0 0 2 * * *

Meaning: run every day at 02:00

NestJS expects 6 fields.
If you pass 5 fields, the expression can be parsed with the wrong positions and the timing becomes incorrect.

4. Field layout for the 6-field format

┌──────────── second (0–59)
│ ┌────────── minute (0–59)
│ │ ┌──────── hour (0–23)
│ │ │ ┌────── day (1–31)
│ │ │ │ ┌──── month (1–12)
│ │ │ │ │ ┌── weekday (0–7, where 0/7 = Sunday)
│ │ │ │ │ │
0  0  2  *  *  *   -> runs every day at 02:00:00

5. Quick syntax reference

6. Common 6-field expressions

7. A good NestJS pattern

1) Put schedule values in environment variables

# .env.production
CLEANUP_ENABLED=true
CLEANUP_CRON="0 0 2 * * *"
CLEANUP_TIMEZONE=UTC

2) Centralize them in a config object

export class RateLimitConfig {
  static readonly CLEANUP = {
    ENABLED: process.env.CLEANUP_ENABLED === 'true',
    CRON: process.env.CLEANUP_CRON || '0 0 2 * * *',
    TIMEZONE: process.env.CLEANUP_TIMEZONE || 'UTC',
  };
}

3) Register the job in a service

@Cron(RateLimitConfig.CLEANUP.CRON, {
  name: 'cleanup-job',
  timeZone: RateLimitConfig.CLEANUP.TIMEZONE,
})
async cleanup() {
  if (!RateLimitConfig.CLEANUP.ENABLED) return;
  // your cleanup logic...
}

8. Common mistakes

9. Time zones

• Cron uses the system time zone by default. In cloud and container environments that often means UTC.
• A practical rule: use Asia/Shanghai while developing locally if that matches your time zone, and use UTC in production for consistency.

@Cron('0 0 2 * * *', { timeZone: 'Asia/Shanghai' })

10. Validation and debugging

Local validation

npm i cron-parser

import * as parser from 'cron-parser';

const it = parser.parseExpression('0 0 2 * * *');
console.log('Next 5 runs:');
for (let i = 0; i < 5; i++) console.log(it.next().toString());

Online tools

• 5-field expressions: https://crontab.guru/
• 6-field expressions: https://crontab.cronhub.io/

11. A simple timeline example

Timeline example for 0 0 2 * * *:
00:00 ------------+------------+------------+------------
                    ^
                    +-- 02:00:00 every day

12. Where does Cron fit conceptually?

Domain: job scheduling and system automation.
Stack position: backend infrastructure, somewhere between application logic and system operations.
Relation to databases: it often triggers database backup, cleanup, or archive jobs, but Cron itself is not a database technology.

A simple mental map:

Software Engineering
 ├─ Backend
 │   ├─ Web frameworks (NestJS, Spring)
 │   ├─ Job queues (BullMQ, Celery)
 │   └─ Scheduled tasks (Cron / @nestjs/schedule)  <-
 ├─ System Operations
 │   ├─ Process management (pm2, systemd)
 │   └─ Cron daemon (crond)  <-
 └─ Database Administration