README.md

cron-parser

Node.js library for parsing crontab instructions

Setup

npm install cron-parser

Supported format

*    *    *    *    *    *
┬    ┬    ┬    ┬    ┬    ┬
│    │    │    │    │    |
│    │    │    │    │    └ day of week (0 - 6)
│    │    │    │    └───── month (0 - 11)
│    │    │    └────────── day of month (1 - 31)
│    │    └─────────────── hour (0 - 23)
│    └──────────────────── minute (0 - 59)
└───────────────────────── second (0 - 59, optional)

Supports mixed use of ranges and range increments (L, W and # characters are not supported currently). See tests for examples.

Usage

Simple expression.

var parser = require('cron-parser');

parser.parseExpression('*/2 * * * *', function(err, interval) {
  if (err) {
    console.log('Error: ' + err.message);
    return;
  }

  console.log('Date: ', interval.next()); // Sat Dec 29 2012 00:42:00 GMT+0200 (EET)
  console.log('Date: ', interval.next()); // Sat Dec 29 2012 00:44:00 GMT+0200 (EET)
});

Define start and end date (limited timespan).

var parser = require('cron-parser');

var options = {
  currentDate: new Date('Wed, 26 Dec 2012 12:38:53 UTC'),
  endDate: new Date('Wed, 26 Dec 2012 14:40:00 UTC')
};

parser.parseExpression('*/22 * * * *', options, function(err, interval) {
  if (err) {
    console.log('Error: ' + err.message);
    return;
  }

  while (true) {
    try {
  		console.log(interval.next());
  	} catch (e) {
  		break;
  	}
  }

  // Wed Dec 26 2012 14:44:00 GMT+0200 (EET)
  // Wed Dec 26 2012 15:00:00 GMT+0200 (EET)
  // Wed Dec 26 2012 15:22:00 GMT+0200 (EET)
  // Wed Dec 26 2012 15:44:00 GMT+0200 (EET)
  // Wed Dec 26 2012 16:00:00 GMT+0200 (EET)
  // Wed Dec 26 2012 16:22:00 GMT+0200 (EET)
});