Saturnus

Saturnus is a cron parser for ES6, using Moment.js to parse into manageable dates.

Installation

``bash
npm install saturnus
`

Introduction

You must know about cron and its expressions, well... sometimes it can be a pain parsing them by yourself. Specially if you only want to validate an ISO string. That's when Saturnus comes into play.

This library is under heavy development, because (guess what?) us, "the creators", are using it for many projects so... we might as well share part of our efforts with the Node community. ;)

Quickstart

`js
const Saturnus = require('saturnus');

//Don't worry I'm bot asynchronous and I'm non-blocking
let chronos = new Saturnus(' *');
//But if you need me on the fly...
let buildingCron = new Saturnus();
buildingCron.parse()
.every().step(5).second() //Every five seconds
.at(15).minute() //At minute 15
.between(12, 15).hours() //From 12 to 3 p.m.
.every.weekday() //Any day of the weekday
.between(2,9).step(2).months() //In February, April, June and August
.exec() //Finish building
`

When returning a date, we use Moment.js, so it can be easier to manipulate.

And knowing that, just a glimpse at the methods and you're ready to go.

Configuration

When creating a parsed expression, you can use various options to change its behaviour. The defaults are shown below:

`js
let options = {
throw: false, //Throw errors in real time (bad for callbacks)
startDate: Date.now(), //When to start validating
endDate: '3000-12-31T23:59', //When to stop recognizing dates
locale: 'en', //Locale for prettify
};
let chronos = new Saturnus(' *');

`

If you use throw:false, be aware that the attibute isValid will be set to false.

`js
let options = {
throw: false,
};
let chronos = new Saturnus('*');
chronos.isValid //false
``

_For the complete docs be sure to visit the_ wiki.

_________________