getNextCronDate

function getNextCronDate(
   expression, 
   currentDate?, 
   timezone?
): Date;

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

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)
timezone?	string	IANA timezone (default: server’s local timezone)

Returns

Date

The next scheduled run date

Throws

If the cron expression or timezone 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');