getNextCronDate

function getNextCronDate(expression, currentDate?): Date;

Defined in: packages/core/src/shared/utils/cron.ts:28

Parse a cron expression and return the next scheduled run date.

Parameters

Parameter	Type	Description
expression	string	A 5-field cron expression (minute hour day-of-month month day-of-week) or a predefined expression
currentDate?	Date	The reference date for calculating next run (default: now)

Returns

Date

The next scheduled run date

Throws

If the cron expression is invalid

Example

// Every minute
const nextRun = getNextCronDate('* * * * *');

// Every day at midnight
const nextRun = getNextCronDate('0 0 * * *');

// Using predefined expression
const nextRun = getNextCronDate('@daily');

// Every Monday at 9am
const nextRun = getNextCronDate('0 9 * * 1');