Skip to content

πŸ“† A microscopic parser for standard cron expressions.

License

Notifications You must be signed in to change notification settings

cheap-glitch/mi-cron

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

49 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“† mi-cron

License Latest release Coverage status

mi-cron is a microscopic (~1KB minified & gzipped) parser for standard cron expressions.

Features

  • Supports the complete standard cron syntax
  • Supports some convenient syntax extensions: @-shorthands (@daily) and steps (*/10)
  • Can compute the next scheduled date for a given expression
  • Tiny & dependency-free

Installation

npm i @cheap-glitch/mi-cron

Usage

const { parseCron } = require('@cheap-glitch/mi-cron');

console.log(parseCron.nextDate('*/5 6-12 3 3 *').toUTCString());
// Wed, 03 Mar 2021 06:00:00

API

parseCron(exp: string): CronSchedule

Parses a standard cron expression. Supports:

  • globs (*)
  • ranges (0-30, mon-fri)
  • steps (*/3, 20-31/2, 10/5)
  • lists (1,15, 0-10,20-30/2)
  • @-shorthands (@weekly)

Does NOT support:

  • L, W, #, ?, H
  • year field
  • @reboot

Returns an object with all possible values for each field (minutes, hours, days, months and days of the week), or undefined if the expression is invalid (wrong syntax, unsupported instruction, impossible range, etc).

const { parseCron } = require('@cheap-glitch/mi-cron');

console.log(parseCron('*/5 6-10 1,15 * wed'));
// {
// 	minutes:  [0, 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55],
// 	hours:    [6, 7, 8, 9, 10],
// 	days:     [1, 15],
// 	months:   [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12],
// 	weekDays: [3],
// }

parseCron.nextDate(exp: string | CronSchedule[, from: Date = new Date.now()]): Date

Takes a cron schedule or expression and returns the next date that matches the schedule, or undefined if the expression is invalid. If given a datetime as the second argument, it will start the computation from this time (otherwise it will use the current datetime at the moment it's called).

const { parseCron } = require('@cheap-glitch/mi-cron');

console.log(parseCron.nextDate('* * * * *', new Date('01 Jan 2020 00:00:00 GMT')).toUTCString());
// Wed, 01 Jan 2020 00:01:00

// Get the next five scheduled dates
const schedule = parseCron('@weekly');
const nextDate = new Date();
for (let i=0; i<5; i++) {
	console.log(nextDate = parseCron.nextDate(schedule, nextDate));
}

Changelog

See the full changelog here.

Contributing

Contributions are welcomed! Please open an issue before submitting substantial changes.

Related

License

ISC