@devkits/cron-parser

Parse cron expressions to human-readable descriptions. Calculate next run times. Zero-dependency cron utility for scheduling tasks.

💰 Support DevKits

Love these tools? Support development via Open Collective

• $5/mo - Supporter (priority support)
• $9/mo - Pro (early access to new tools)
• $29 - Lifetime (all current + future Pro features)

💎 Upgrade to DevKits Pro

Get access to 20+ premium tools including SQL to Code, Data Faker, JWT Generator, and more — all for $9 one-time.

→ Unlock DevKits Pro

💡 Pay with Crypto: BTC, ETH, USDT (TRC-20), SOL accepted. View crypto addresses

🧰 DevKits Pro Tools

This package is part of DevKits — 82+ free developer tools. The online Cron Parser shows next 100 run times, timezone conversion, and cron pattern templates.

→ Explore Cron Tools

Installation

npm install @devkits/cron-parser

Usage

const { parse, nextRuns, next, isValid, ALIASES } = require('@devkits/cron-parser');

// Parse cron expression to human-readable
const result = parse('*/5 * * * *');
// { expression: '*/5 * * * *', human: 'Every 5 minutes', valid: true }

parse('0 9 * * 1-5');
// { expression: '0 9 * * 1-5', human: 'At 09:00, on Monday-Tuesday-Wednesday-Thursday-Friday', valid: true }

// Get next run times
const runs = nextRuns('0 0 * * *', 5);
// Array of next 5 midnight dates

// Get single next run
const nextRun = next('0 9 * * 1');
// Next Monday at 9:00 AM

// Validate cron expressions
isValid('0 0 * * *'); // true
isValid('invalid'); // false

// Access aliases
console.log(ALIASES['@daily']);
// '0 0 * * *'

API

parse(expression)

Parses a cron expression and returns:

• expression: Normalized expression
• human: Human-readable description
• valid: Boolean indicating if expression is valid
• error: Error message if invalid

nextRuns(expression, count)

Returns array of next run dates (default: 5 occurrences).

next(expression)

Returns the next single run date.

isValid(expression)

Validates a cron expression.

ALIASES

Object containing cron aliases (@daily, @hourly, etc.).

Supported Cron Syntax

| Field | Values | Special chars | |-------|--------|---------------| | Minute | 0-59 | * , - / | | Hour | 0-23 | * , - / | | Day of Month | 1-31 | * , - / | | Month | 1-12 (or JAN-DEC) | * , - / | | Day of Week | 0-6 (or SUN-SAT) | * , - / |

Examples

| Expression | Description | |------------|-------------| | * * * * * | Every minute | | */5 * * * * | Every 5 minutes | | 0 * * * * | Every hour at minute 0 | | 0 0 * * * | Daily at midnight | | 0 9 * * 1-5 | Weekdays at 9:00 AM | | 0 0 1 * * | Monthly on the 1st | | 0 0 1 1 * | Yearly on January 1st |

See Also

🔧 More DevKits Tools

Free Tools (82+): | Tool | Description | |------|-------------| | base64-tool | Base64 encode/decode | | chmod-calculator | Unix permissions converter | | csv-json-converter | CSV ↔ JSON converter | | diff-checker | Text comparison (LCS) | | docker-compose-parser | Docker Compose parser |

→ Browse All 82+ Free Tools

💎 DevKits Pro — $9 One-Time

Unlock 20+ premium tools with a single payment:

• SQL to Code
• Data Faker
• JWT Generator
• Crypto Hash
• URL Parser
• Color Converter
• Timestamp Tool
• Slug Generator

→ Unlock DevKits Pro for $9

💡 Pay with Crypto: BTC, ETH, USDT (TRC-20), SOL accepted

🚀 Other Products from Us

| Product | Description | |---------|-------------| | Invoicely | Free invoice generator for freelancers | | SnapOG | Free OG image generator (20+ templates) |

License

MIT