devkits-cron-parser

@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