Cron

Parse and match cron expressions

Edit and run examples against `ts-time-utils@4.4.1` in your browser.

Cron Matching

Check if dates match cron expressions

index.ts

import { matchesCron, getNextCronDate, isValidCron, CRON_PRESETS } from 'ts-time-utils/cron';

// Validate cron expression
console.log(isValidCron('0 9 * * 1-5')); // true
console.log(isValidCron('invalid')); // false

// Check if date matches
const monday9am = new Date('2025-09-15T09:00:00'); // Monday
console.log(matchesCron(monday9am, '0 9 * * 1')); // true (Mon 9am)
console.log(matchesCron(monday9am, '0 9 * * 5')); // false (not Fri)

// Get next occurrence
const next = getNextCronDate('0 9 * * 1-5'); // Next weekday 9am
console.log('Next weekday 9am:', next);

// Use presets
console.log(CRON_PRESETS.everyDay);   // "0 0 * * *"
console.log(CRON_PRESETS.everyWeek);  // "0 0 * * 0"
console.log(CRON_PRESETS.everyMonth); // "0 0 1 * *"
console.log(CRON_PRESETS.weekdays);   // "0 0 * * 1-5"

Console

Press Run to execute the example.