croner 4.0.53 → 4.0.57

package/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [hexagon]

package/README.md

@@ -4,35 +4,45 @@
 [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/Hexagon/croner/blob/master/LICENSE) [![jsdelivr](https://data.jsdelivr.com/v1/package/npm/croner/badge?style=rounded)](https://www.jsdelivr.com/package/npm/croner)
 
 *   Trigger functions in javascript using [Cron](https://en.wikipedia.org/wiki/Cron#CRON_expression) syntax.
-*   Pause, resume or stop exection efter a task is scheduled.
+*   Pause, resume or stop execution efter a task is scheduled.
 *   Find first date of next month, find date of next tuesday, etc.
 *   Supports Node.js from 4.0 to current. Both require (commonjs) and import (module).
 *   Supports browser use ([UMD](https://github.com/umdjs/umd) (standalone, requirejs etc.), [ES-module](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules))
-*   *Experimental:* Schedule in other timezone than default.
+*   **Experimental:** Schedule in other timezones than default.
 
 Documented with [JSDoc](https://jsdoc.app/) for intellisense, and include [TypeScript](https://www.typescriptlang.org/) typings.
 
-```html
-<script src="https://cdn.jsdelivr.net/npm/croner@4/dist/croner.min.js"></script>
-```
+Quick demo:
 
 ```javascript
-// Run a function each second
-Cron('* * * * * *', function () {
+// Run a function at the interval set by a cron expression
+let job = Cron('* * * * * *', () => {
 	console.log('This will run every second');
 });
 
-// What date is next sunday?
-console.log(Cron('0 0 0 * * 7').next().toLocaleDateString());
+// Control execution
+// job.pause();
+// job.resume();
+// job.stop();
+
+// Get info
+let next = job.next();
+let previous = job.previous();
 ```
 
-## Installation
+```javascript
+// What date is next sunday?
+let nextSunday = Cron('0 0 0 * * 7').next();
+console.log(nextSunday.toLocaleDateString());
 
-### Manual
+// How many days left to christmas eve?
+let msLeft = Cron('59 59 23 24 DEC *').next() - new Date();
+console.log(Math.floor(msLeft/1000/3600/24) + " days left to next christmas eve");
+```
 
-*   Download latest [zipball](http://github.com/Hexagon/croner/zipball/master/)
-*   Unpack
-*   Grab ```croner.min.js``` ([UMD](https://github.com/umdjs/umd)) or ```croner.min.mjs``` ([ES-module](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)) from the [dist/](/dist) folder
+More [examples](#examples)...
+
+## Installation
 
 ### Node.js
 
@@ -49,7 +59,15 @@ import Cron from "croner";
 const Cron = require("croner");
 ```
 
-### CDN
+### Browser 
+
+#### Manual
+
+*   Download latest [zipball](http://github.com/Hexagon/croner/zipball/master/)
+*   Unpack
+*   Grab ```croner.min.js``` ([UMD](https://github.com/umdjs/umd)) or ```croner.min.mjs``` ([ES-module](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)) from the [dist/](/dist) folder
+
+#### CDN
 
 To use as a [UMD](https://github.com/umdjs/umd)-module (stand alone, [RequireJS](https://requirejs.org/) etc.)
 
@@ -83,133 +101,148 @@ To use as a [ES-module](https://developer.mozilla.org/en-US/docs/Web/JavaScript/
 </script>
 ```
 
-## Examples 
+## Signature
 
-### Minimalist scheduling
-```javascript
-// Run a function each second
-Cron('* * * * * *', function () {
-	console.log('This will run every second');
-});
-```
+Cron takes three arguments; [pattern](#pattern), [options](#options) (optional) and a scheduled function (optional).
 
-### Find dates
 ```javascript
-// Find next month
-let nextMonth = Cron('0 0 0 1 * *').next(),
-	nextSunday = Cron('0 0 0 * * 7').next();
 
-console.log("First day of next month: " +  nextMonth.toLocaleDateString());
-console.log("Next sunday: " +  nextSunday.toLocaleDateString());
-```
+var scheduler = Cron( <string pattern> [, { ... } ] [, <function toBeRun> ] );
 
-### Minimalist scheduling with stepping and custom timezone
-```javascript
-// Run a function every fifth second
-Cron('*/5 * * * * *', { timezone: 'Europe/Stockholm' }, function () {
-	console.log('This will run every fifth second');
-});
 ```
 
-### Minimalist scheduling with range
-```javascript
-// Run a function the first five seconds of a minute
-Cron('0-4 * * * * *', function () {
-	console.log('This will run the first five seconds every minute');
-});
-```
+Cron return a scheduler, which can be used in a couple of different ways.
 
-### Minimalist scheduling with options
 ```javascript
-// Run a function each second, limit to five runs
-Cron('* * * * * *', { maxRuns: 5 }, function () {
-	console.log('This will run each second, but only five times.');
-});
+job.next( [ <date previous> ] );	// Get a Date object with next run time according 
+					// to pattern relative to previous, or now if omitted
+
+job.msToNext( [ <date previous> ] );    // Get milliseconds left to next execution
+
+job.previous();				// Gets a Date object with previous run time, or null
+
+job.schedule( <fn job> );		// If you didn't pass a function to constructor, you can do it here
+
+job.pause();				// Pause execution
+job.resume();				// Resume execution
+job.stop();				// Stop execution
 ```
 
-### Minimalist scheduling with job controls
+## Options
+
+Options are optional, and passed as the second parameter of cron.
+
+Example:
+
 ```javascript
-// Run a function each second, get reference to job
-var job = Cron('* * * * * *', function () {
-	console.log('This will run each second.');
-});
+Cron( '* * * * * *', { maxRuns: 4 } );
+```
 
-// Pause job
-job.pause();
+| Key          | Default value  | Data type      | Remarks                               |
+|--------------|----------------|----------------|---------------------------------------|
+| maxRuns      | Infinite       | Number         |                                       |
+| timezone     | undefined      | String         | Timezone in Europe/Stockholm format   |
+| startAt      | undefined      | String         | ISO 8601 formatted datetime (2021-10-17T23:43:00)<br>in local or specified timezone |
+| stopAt       | undefined      | String         | ISO 8601 formatted datetime (2021-10-17T23:43:00)<br>in local or specified timezone |
+| paused       | false          | Boolean        | If the job should be paused from start. |
 
-// Resume job
-job.resume();
+## Pattern
 
-// Stop job
-job.stop();
+Pattern is mandatory, and passed as the first argument of Cron.
 
-```
+Example:
 
-### Basic scheduling
 ```javascript
+Cron( '* * * * * *', () => {} );
+```
 
-// Run every minute
-var scheduler = Cron('0 * * * * *');
+Composition:
 
-scheduler.schedule(function() {
-	console.log('This will run every minute');
-});
+```
+┌──────────────── (optional) second (0 - 59)
+│ ┌────────────── minute (0 - 59)
+│ │ ┌──────────── hour (0 - 23)
+│ │ │ ┌────────── day of month (1 - 31)
+│ │ │ │ ┌──────── month (1 - 12, JAN-DEC)
+│ │ │ │ │ ┌────── day of week (0 - 6, SUN-Mon) 
+│ │ │ │ │ │       (0 to 6 are Sunday to Saturday; 7 is Sunday, the same as 0)
+│ │ │ │ │ │
+* * * * * *
 ```
 
-### Scheduling with options
-```javascript
+Details:
+
+| Field        | Required | Allowed values | Allowed special characters | Remarks                               |
+|--------------|----------|----------------|----------------------------|---------------------------------------|
+| Seconds      | Optional | 0-59           | * , - /                    |                                       |
+| Minutes      | Yes      | 0-59           | * , - /                    |                                       |
+| Hours        | Yes      | 0-23           | * , - /                    |                                       |
+| Day of Month | Yes      | 1-31           | * , - /                    |                                       |
+| Month        | Yes      | 1-12 or JAN-DEC| * , - /                    |                                       |
+| Day of Week  | Yes      | 0-7 or SUN-MON | * , - /                    | 0 to 6 are Sunday to Saturday<br>7 is Sunday, the same as 0            |
 
-// Run every minute
-var scheduler = Cron('0 * * * * *', { maxRuns: 5 });
+**Note**: Weekday and month names are case insensitive. Both MON and mon works.
 
-// Schedule with options (all options are optional)
-scheduler.schedule(function() {
-	console.log('This will run every minute.');
+## Examples 
+
+### Minimal
+```javascript
+// Run a function each second
+Cron('* * * * * *', () => {
+	console.log('This will run every second');
 });
 ```
-### Scheduling with controls
-```javascript
-let scheduler = Cron('* * * * * *')
 
-scheduler.schedule(function () {
-	console.log('This will run every second. Pause on second 10. Resume on second 15. And quit on second 20.');
-	console.log('Current second: ', new Date().getSeconds());
-	console.log('Previous run: ' + scheduler.previous());
-	console.log('Next run: ' + scheduler.next());
+### Expressions
+```javascript
+// Run a function the first five seconds of a minute
+Cron('0-4 */5 1,2,3 * JAN-MAR SAT', function () {
+	console.log('This will run the first five seconds every fifth minute');
+	console.log('of hour 1,2 and 3 every saturday in January to March.');
 });
-
-Cron('10 * * * * *', {maxRuns: 1}, () => scheduler.pause());
-Cron('15 * * * * *', {maxRuns: 1}, () => scheduler.resume());
-Cron('20 * * * * *', {maxRuns: 1}, () => scheduler.stop());
 ```
 
-## Full API
+### Find dates
 ```javascript
+// Find next month
+let nextMonth = Cron('0 0 0 1 * *').next(),
+	nextSunday = Cron('0 0 0 * * 7').next(),
+	nextSat29feb = Cron("0 0 0 29 2 6").next();
 
-var scheduler = Cron( <string pattern> [, { startAt: <date|string>, stopAt: <date|string>, maxRuns: <integer>, timezone: <string> } ] [, <function job> ] )
+console.log("First day of next month: " +  nextMonth.toLocaleDateString());
+console.log("Next sunday: " +  nextSunday.toLocaleDateString());
+console.log("Next saturday at 29th of february: " +  nextSat29feb.toLocaleDateString());  // 2048-02-29
+```
 
-scheduler.next( [ <date previous> ] );
-scheduler.msToNext( [ <date previous> ] );
-scheduler.previous();
-scheduler.schedule( <fn job> );
-scheduler.pause();
-scheduler.resume();
-scheduler.stop();
+### With options
+```javascript
 
+var job = Cron(
+	'* * * * *', 
+	{ 
+		maxRuns: Infinity, 
+		startAt: "2021-11-01T00:00:00", 
+		stopAt: "2021-12-01T00:00:00",
+		timezone: "Europe/Stockholm"
+	},
+	function() {
+		console.log('This will run every minute, from 2021-11-01 to 2021-12-01 00:00:00 in Europe/Stockholm.');
+	}
+);
 ```
 
-## Pattern
+### Job controls
+```javascript
+let job = Cron('* * * * * *', () => {
+	console.log('This will run every second. Pause on second 10. Resume on second 15. And quit on second 20.');
+	console.log('Current second: ', new Date().getSeconds());
+	console.log('Previous run: ' + job.previous());
+	console.log('Next run: ' + job.next());
+});
 
-```
-┌──────────────── (optional) second (0 - 59)
-│ ┌────────────── minute (0 - 59)
-│ │ ┌──────────── hour (0 - 23)
-│ │ │ ┌────────── day of month (1 - 31)
-│ │ │ │ ┌──────── month (1 - 12)
-│ │ │ │ │ ┌────── day of week (0 - 6) 
-│ │ │ │ │ │       (0 to 6 are Sunday to Saturday; 7 is Sunday, the same as 0)
-│ │ │ │ │ │
-* * * * * *
+Cron('10 * * * * *', {maxRuns: 1}, () => job.pause());
+Cron('15 * * * * *', {maxRuns: 1}, () => job.resume());
+Cron('20 * * * * *', {maxRuns: 1}, () => job.stop());
 ```
 
 ## License

package/dist/croner.min.js

@@ -1 +1 @@
-!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.Cron=e():t.Cron=e()}(this,(function(){return(()=>{"use strict";var t={d:(e,r)=>{for(var o in r)t.o(r,o)&&!t.o(e,o)&&Object.defineProperty(e,o,{enumerable:!0,get:r[o]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};t.d(e,{default:()=>i});function r(t,e){if(this.timezone=e,t&&t instanceof Date)this.fromDate(t);else if(void 0===t)this.fromDate(new Date);else if(t&&"string"==typeof t)this.fromString(t);else{if(!(t instanceof r))throw new TypeError("CronDate: Invalid type ("+typeof t+") passed as parameter to CronDate constructor");this.fromCronDate(t)}}function o(t){this.pattern=t,this.seconds=Array(60).fill(0),this.minutes=Array(60).fill(0),this.hours=Array(24).fill(0),this.days=Array(31).fill(0),this.months=Array(12).fill(0),this.daysOfWeek=Array(8).fill(0),this.parse()}r.prototype.fromDate=function(t){let e=t.getTime();this.timezone&&(t=function(t,e){return new Date(t.toLocaleString("en-US",{timeZone:e}))}(t,this.timezone));let r=t.getTime();this.UTCmsOffset=r-e,this.milliseconds=t.getMilliseconds(),this.seconds=t.getSeconds(),this.minutes=t.getMinutes(),this.hours=t.getHours(),this.days=t.getDate(),this.months=t.getMonth(),this.years=t.getFullYear()},r.prototype.fromCronDate=function(t){this.UTCmsOffset=t.UTCmsOffset,this.timezone=t.timezone;let e=new Date(t.years,t.months,t.days,t.hours,t.minutes,t.seconds,t.milliseconds);this.milliseconds=e.getMilliseconds(),this.seconds=e.getSeconds(),this.minutes=e.getMinutes(),this.hours=e.getHours(),this.days=e.getDate(),this.months=e.getMonth(),this.years=e.getFullYear()},r.prototype.fromString=function(t){let e=Date.parse(t);if(isNaN(e))throw new TypeError("CronDate: Provided string value for CronDate could not be parsed as date.");this.fromDate(new Date(e))},r.prototype.increment=function(t,e){e||(this.seconds+=1);let o=this.getTime();this.milliseconds=0;let n=this,s=function(t,e,r,o){for(let s=void 0===o?n[t]+r:0+r;s<e[t].length;s++)if(e[t][s])return n[t]=s-r,!0;return!1},i=function(){for(;h>=0;)s(a[h][0],t,a[h][2],0),h--},a=[["seconds","minutes",0],["minutes","hours",0],["hours","days",0],["days","months",-1],["months","years",0]],h=0;for(;h<5;)s(a[h][0],t,a[h][2])||(this[a[h][1]]++,i()),h++;for(;!t.daysOfWeek[this.getDate().getDay()];)this.days+=1,h=2,i();return o!=n.getTime()?(n=new r(n),this.years>=4e3?null:n.increment(t,!0)):this},r.prototype.getDate=function(){return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-this.UTCmsOffset)},r.prototype.getTime=function(){return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-this.UTCmsOffset).getTime()},o.prototype.parse=function(){if("string"!=typeof this.pattern&&this.pattern.constructor!==String)throw new TypeError("CronPattern: Pattern has to be of type string.");let t,e,r=this.pattern.trim().replace(/\s+/g," ").split(" "),o=/[^/*0-9,-]+/;if(r.length<5||r.length>6)throw new TypeError("CronPattern: invalid configuration format ('"+this.pattern+"'), exacly five or six space separated parts required.");for(5===r.length&&r.unshift("0"),e=0;e<r.length;e++)if(t=r[e].trim(),o.test(t))throw new TypeError("CronPattern: configuration entry "+(e+1)+" ("+t+") contains illegal characters.");this.partToArray("seconds",r[0],0),this.partToArray("minutes",r[1],0),this.partToArray("hours",r[2],0),this.partToArray("days",r[3],-1),this.partToArray("months",r[4],-1),this.partToArray("daysOfWeek",r[5],0),this.daysOfWeek[7]&&(this.daysOfWeek[0]=1)},o.prototype.partToArray=function(t,e,r){let o,n,s,i,a,h=this[t];if("*"!==e)if(n=e.split(","),n.length>1)for(o=0;o<n.length;o++)this.partToArray(t,n[o],r);else if(-1!==e.indexOf("-")){if(n=e.split("-"),2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal range: '"+e+"'");if(s=parseInt(n[0],10)+r,i=parseInt(n[1],10)+r,isNaN(s))throw new TypeError("CronPattern: Syntax error, illegal lower range (NaN)");if(isNaN(i))throw new TypeError("CronPattern: Syntax error, illegal upper range (NaN)");if(s<0||i>=h.length)throw new TypeError("CronPattern: Value out of range: '"+e+"'");if(s>i)throw new TypeError("CronPattern: From value is larger than to value: '"+e+"'");for(o=s;o<=i;o++)h[o+r]=1}else if(-1!==e.indexOf("/")){if(n=e.split("/"),2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal stepping: '"+e+"'");if("*"!==n[0])throw new TypeError("CronPattern: Syntax error, left part of / needs to be * : '"+e+"'");if(a=parseInt(n[1],10),isNaN(a))throw new TypeError("CronPattern: Syntax error, illegal stepping: (NaN)");if(0===a)throw new TypeError("CronPattern: Syntax error, illegal stepping: 0");if(a>h.length)throw new TypeError("CronPattern: Syntax error, steps cannot be greater than maximum value of part ("+h.length+")");for(o=0;o<h.length;o+=a)h[o+r]=1}else{if(o=parseInt(e,10)+r,o<0||o>=h.length)throw new TypeError("CronPattern: "+t+" value out of range: '"+e+"'");h[o]=1}else for(o=0;o<h.length;o++)h[o]=1};const n=Math.pow(2,31)-1;function s(t,e,r){return this instanceof s?(this.pattern=new o(t),"function"==typeof e&&(r=e,e=void 0),this.options=this.processOptions(e),void 0!==r&&this.schedule(r),this):new s(t,e,r)}s.prototype.processOptions=function(t){return void 0===t&&(t={}),t.paused=void 0!==t.paused&&t.paused,t.maxRuns=void 0===t.maxRuns?1/0:t.maxRuns,t.kill=!1,t.startAt&&(t.startAt=new r(t.startAt,t.timezone)),t.stopAt&&(t.stopAt=new r(t.stopAt,t.timezone)),t},s.prototype.next=function(t){let e=this._next(t);return e?e.getDate():null},s.prototype.previous=function(){return this.previousrun?this.previousrun.getDate():null},s.prototype._next=function(t){t=new r(t,this.options.timezone),this.options.startAt&&t&&t.getTime()<this.options.startAt.getTime()&&(t=new r(this.options.startAt,this.options.timezone));let e=new r(t,this.options.timezone).increment(this.pattern);return null===e||this.options.maxRuns<=0||this.options.kill||this.options.stopAt&&e.getTime()>=this.options.stopAt.getTime()?null:e},s.prototype.msToNext=function(t){t=t||new r(void 0,this.options.timezone);let e=this._next(t);return e?e.getTime()-t.getTime():null},s.prototype.stop=function(){this.options.kill=!0,this.currentTimeout&&clearTimeout(this.currentTimeout)},s.prototype.pause=function(){return(this.options.paused=!0)&&!this.options.kill},s.prototype.resume=function(){return!(this.options.paused=!1)&&!this.options.kill},s.prototype.schedule=function(t){let e=this,o=this.msToNext(e.previousrun),s=e.maxDelay||n;return o>s&&(o=s),null!==o&&(e.currentTimeout=setTimeout((function(){o!==s&&(e.options.paused||(e.options.maxRuns--,t()),e.previousrun=new r(void 0,e.options.timezone)),e.schedule(t)}),o)),this};const i=s;return e.default})()}));
+!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.Cron=e():t.Cron=e()}(this,(function(){return(()=>{"use strict";var t={d:(e,r)=>{for(var n in r)t.o(r,n)&&!t.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:r[n]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};t.d(e,{default:()=>o});function r(t,e){if(this.timezone=e,t&&t instanceof Date)this.fromDate(t);else if(void 0===t)this.fromDate(new Date);else if(t&&"string"==typeof t)this.fromString(t);else{if(!(t instanceof r))throw new TypeError("CronDate: Invalid type ("+typeof t+") passed as parameter to CronDate constructor");this.fromCronDate(t)}}function n(t){this.pattern=t,this.seconds=Array(60).fill(0),this.minutes=Array(60).fill(0),this.hours=Array(24).fill(0),this.days=Array(31).fill(0),this.months=Array(12).fill(0),this.daysOfWeek=Array(8).fill(0),this.parse()}r.prototype.fromDate=function(t,e){if(this.timezone){let r=t.getTime(),n=function(t,e){return new Date(t.toLocaleString("en-US",{timeZone:e}))}(t,this.timezone);e||(t=n),this.UTCmsOffset=n.getTime()-r}else this.UTCmsOffset=0;this.milliseconds=t.getMilliseconds(),this.seconds=t.getSeconds(),this.minutes=t.getMinutes(),this.hours=t.getHours(),this.days=t.getDate(),this.months=t.getMonth(),this.years=t.getFullYear()},r.prototype.fromCronDate=function(t){this.UTCmsOffset=t.UTCmsOffset,this.timezone=t.timezone;let e=new Date(t.years,t.months,t.days,t.hours,t.minutes,t.seconds,t.milliseconds);this.milliseconds=e.getMilliseconds(),this.seconds=e.getSeconds(),this.minutes=e.getMinutes(),this.hours=e.getHours(),this.days=e.getDate(),this.months=e.getMonth(),this.years=e.getFullYear()},r.prototype.fromString=function(t){let e=this.parseISOLocal(t);if(isNaN(e))throw new TypeError("CronDate: Provided string value for CronDate could not be parsed as date.");this.fromDate(new Date(e),!0)},r.prototype.increment=function(t,e){e||(this.seconds+=1);let n=this.getTime();this.milliseconds=0;let i=this,s=function(t,e,r,n){for(let s=void 0===n?i[t]+r:0+r;s<e[t].length;s++)if(e[t][s])return i[t]=s-r,!0;return!1},o=function(){for(;p>=0;)s(a[p][0],t,a[p][2],0),p--},a=[["seconds","minutes",0],["minutes","hours",0],["hours","days",0],["days","months",-1],["months","years",0]],p=0;for(;p<5;)s(a[p][0],t,a[p][2])||(this[a[p][1]]++,o()),p++;for(;!t.daysOfWeek[this.getDate(!0).getDay()];)this.days+=1,p=2,o();return n!=i.getTime()?(i=new r(i),this.years>=4e3?null:i.increment(t,!0)):this},r.prototype.getDate=function(t){let e=t?0:this.UTCmsOffset;return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-e)},r.prototype.getTime=function(t){let e=t?0:this.UTCmsOffset;return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-e).getTime()},r.prototype.parseISOLocal=function(t){let e=t.split(/\D/);if(e.length<6)return NaN;let r=parseInt(e[0],10),n=parseInt(e[1],10),i=parseInt(e[2],10),s=parseInt(e[3],10),o=parseInt(e[4],10),a=parseInt(e[5],10);return isNaN(r)||isNaN(n)||isNaN(i)||isNaN(s)||isNaN(o)||isNaN(a)?NaN:new Date(r,n-1,i,s,o,a)},n.prototype.parse=function(){if("string"!=typeof this.pattern&&this.pattern.constructor!==String)throw new TypeError("CronPattern: Pattern has to be of type string.");let t=this.pattern.trim().replace(/\s+/g," ").split(" ");if(t.length<5||t.length>6)throw new TypeError("CronPattern: invalid configuration format ('"+this.pattern+"'), exacly five or six space separated parts required.");5===t.length&&t.unshift("0"),t[4]=this.replaceAlphaMonths(t[4]),t[5]=this.replaceAlphaDays(t[5]),this.throwAtIllegalCharacters(t),this.partToArray("seconds",t[0],0),this.partToArray("minutes",t[1],0),this.partToArray("hours",t[2],0),this.partToArray("days",t[3],-1),this.partToArray("months",t[4],-1),this.partToArray("daysOfWeek",t[5],0),this.daysOfWeek[7]&&(this.daysOfWeek[0]=1)},n.prototype.partToArray=function(t,e,r){let n,i,s=this[t];if("*"!==e)if(i=e.split(","),i.length>1)for(n=0;n<i.length;n++)this.partToArray(t,i[n],r);else-1!==e.indexOf("-")?this.handleRange(e,t,r):-1!==e.indexOf("/")?this.handleStepping(e,t,r):this.handleNumber(e,t,r);else for(n=0;n<s.length;n++)s[n]=1},n.prototype.throwAtIllegalCharacters=function(t){let e=/[^/*0-9,-]+/;for(let r=0;r<t.length;r++)if(e.test(t[r]))throw new TypeError("CronPattern: configuration entry "+r+" ("+t[r]+") contains illegal characters.")},n.prototype.handleNumber=function(t,e,r){let n=parseInt(t,10)+r;if(n<0||n>=this[e].length)throw new TypeError("CronPattern: "+e+" value out of range: '"+t+"'");this[e][n]=1},n.prototype.handleRange=function(t,e,r){let n=t.split("-");if(2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal range: '"+t+"'");let i=parseInt(n[0],10)+r,s=parseInt(n[1],10)+r;if(isNaN(i))throw new TypeError("CronPattern: Syntax error, illegal lower range (NaN)");if(isNaN(s))throw new TypeError("CronPattern: Syntax error, illegal upper range (NaN)");if(i<0||s>=this[e].length)throw new TypeError("CronPattern: Value out of range: '"+t+"'");if(i>s)throw new TypeError("CronPattern: From value is larger than to value: '"+t+"'");for(let t=i;t<=s;t++)this[e][t+r]=1},n.prototype.handleStepping=function(t,e,r){let n=t.split("/");if(2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal stepping: '"+t+"'");if("*"!==n[0])throw new TypeError("CronPattern: Syntax error, left part of / needs to be * : '"+t+"'");let i=parseInt(n[1],10);if(isNaN(i))throw new TypeError("CronPattern: Syntax error, illegal stepping: (NaN)");if(0===i)throw new TypeError("CronPattern: Syntax error, illegal stepping: 0");if(i>this[e].length)throw new TypeError("CronPattern: Syntax error, steps cannot be greater than maximum value of part ("+this[e].length+")");for(let t=0;t<this[e].length;t+=i)this[e][t+r]=1},n.prototype.replaceAlphaDays=function(t){return t.replace(/sun/gi,"0").replace(/mon/gi,"1").replace(/tue/gi,"2").replace(/wed/gi,"3").replace(/thu/gi,"4").replace(/fri/gi,"5").replace(/sat/gi,"6")},n.prototype.replaceAlphaMonths=function(t){return t.replace(/jan/gi,"1").replace(/feb/gi,"2").replace(/mar/gi,"3").replace(/apr/gi,"4").replace(/may/gi,"5").replace(/jun/gi,"6").replace(/jul/gi,"7").replace(/aug/gi,"8").replace(/sep/gi,"9").replace(/oct/gi,"10").replace(/nov/gi,"11").replace(/dec/gi,"12")};const i=Math.pow(2,31)-1;function s(t,e,r){return this instanceof s?(this.pattern=new n(t),"function"==typeof e&&(r=e,e=void 0),this.options=this.processOptions(e),void 0!==r&&this.schedule(r),this):new s(t,e,r)}s.prototype.processOptions=function(t){return void 0===t&&(t={}),t.paused=void 0!==t.paused&&t.paused,t.maxRuns=void 0===t.maxRuns?1/0:t.maxRuns,t.kill=!1,t.startAt&&(t.startAt=new r(t.startAt,t.timezone)),t.stopAt&&(t.stopAt=new r(t.stopAt,t.timezone)),t},s.prototype.next=function(t){t=new r(t,this.options.timezone);let e=this._next(t);return e?e.getDate():null},s.prototype.previous=function(){return this.previousrun?this.previousrun.getDate():null},s.prototype._next=function(t){this.options.startAt&&t&&t.getTime(!0)<this.options.startAt.getTime(!0)&&(t=new r(this.options.startAt,this.options.timezone));let e=new r(t,this.options.timezone).increment(this.pattern);return null===e||this.options.maxRuns<=0||this.options.kill||this.options.stopAt&&e.getTime(!0)>=this.options.stopAt.getTime(!0)?null:e},s.prototype.msToNext=function(t){t=new r(t,this.options.timezone);let e=this._next(t);return e?e.getTime(!0)-t.getTime(!0):null},s.prototype.stop=function(){this.options.kill=!0,this.currentTimeout&&clearTimeout(this.currentTimeout)},s.prototype.pause=function(){return(this.options.paused=!0)&&!this.options.kill},s.prototype.resume=function(){return!(this.options.paused=!1)&&!this.options.kill},s.prototype.schedule=function(t){let e=this,n=this.msToNext(e.previousrun),s=e.maxDelay||i;return n>s&&(n=s),null!==n&&(e.currentTimeout=setTimeout((function(){n!==s&&(e.options.paused||(e.options.maxRuns--,t()),e.previousrun=new r(void 0,e.options.timezone)),e.schedule(t)}),n)),this};const o=s;return e.default})()}));

package/dist/croner.min.mjs

@@ -1 +1 @@
-var t={d:(e,r)=>{for(var s in r)t.o(r,s)&&!t.o(e,s)&&Object.defineProperty(e,s,{enumerable:!0,get:r[s]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};t.d(e,{P:()=>o,Z:()=>i});function r(t,e){if(this.timezone=e,t&&t instanceof Date)this.fromDate(t);else if(void 0===t)this.fromDate(new Date);else if(t&&"string"==typeof t)this.fromString(t);else{if(!(t instanceof r))throw new TypeError("CronDate: Invalid type ("+typeof t+") passed as parameter to CronDate constructor");this.fromCronDate(t)}}function s(t){this.pattern=t,this.seconds=Array(60).fill(0),this.minutes=Array(60).fill(0),this.hours=Array(24).fill(0),this.days=Array(31).fill(0),this.months=Array(12).fill(0),this.daysOfWeek=Array(8).fill(0),this.parse()}r.prototype.fromDate=function(t){let e=t.getTime();this.timezone&&(t=function(t,e){return new Date(t.toLocaleString("en-US",{timeZone:e}))}(t,this.timezone));let r=t.getTime();this.UTCmsOffset=r-e,this.milliseconds=t.getMilliseconds(),this.seconds=t.getSeconds(),this.minutes=t.getMinutes(),this.hours=t.getHours(),this.days=t.getDate(),this.months=t.getMonth(),this.years=t.getFullYear()},r.prototype.fromCronDate=function(t){this.UTCmsOffset=t.UTCmsOffset,this.timezone=t.timezone;let e=new Date(t.years,t.months,t.days,t.hours,t.minutes,t.seconds,t.milliseconds);this.milliseconds=e.getMilliseconds(),this.seconds=e.getSeconds(),this.minutes=e.getMinutes(),this.hours=e.getHours(),this.days=e.getDate(),this.months=e.getMonth(),this.years=e.getFullYear()},r.prototype.fromString=function(t){let e=Date.parse(t);if(isNaN(e))throw new TypeError("CronDate: Provided string value for CronDate could not be parsed as date.");this.fromDate(new Date(e))},r.prototype.increment=function(t,e){e||(this.seconds+=1);let s=this.getTime();this.milliseconds=0;let n=this,o=function(t,e,r,s){for(let o=void 0===s?n[t]+r:0+r;o<e[t].length;o++)if(e[t][o])return n[t]=o-r,!0;return!1},i=function(){for(;h>=0;)o(a[h][0],t,a[h][2],0),h--},a=[["seconds","minutes",0],["minutes","hours",0],["hours","days",0],["days","months",-1],["months","years",0]],h=0;for(;h<5;)o(a[h][0],t,a[h][2])||(this[a[h][1]]++,i()),h++;for(;!t.daysOfWeek[this.getDate().getDay()];)this.days+=1,h=2,i();return s!=n.getTime()?(n=new r(n),this.years>=4e3?null:n.increment(t,!0)):this},r.prototype.getDate=function(){return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-this.UTCmsOffset)},r.prototype.getTime=function(){return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-this.UTCmsOffset).getTime()},s.prototype.parse=function(){if("string"!=typeof this.pattern&&this.pattern.constructor!==String)throw new TypeError("CronPattern: Pattern has to be of type string.");let t,e,r=this.pattern.trim().replace(/\s+/g," ").split(" "),s=/[^/*0-9,-]+/;if(r.length<5||r.length>6)throw new TypeError("CronPattern: invalid configuration format ('"+this.pattern+"'), exacly five or six space separated parts required.");for(5===r.length&&r.unshift("0"),e=0;e<r.length;e++)if(t=r[e].trim(),s.test(t))throw new TypeError("CronPattern: configuration entry "+(e+1)+" ("+t+") contains illegal characters.");this.partToArray("seconds",r[0],0),this.partToArray("minutes",r[1],0),this.partToArray("hours",r[2],0),this.partToArray("days",r[3],-1),this.partToArray("months",r[4],-1),this.partToArray("daysOfWeek",r[5],0),this.daysOfWeek[7]&&(this.daysOfWeek[0]=1)},s.prototype.partToArray=function(t,e,r){let s,n,o,i,a,h=this[t];if("*"!==e)if(n=e.split(","),n.length>1)for(s=0;s<n.length;s++)this.partToArray(t,n[s],r);else if(-1!==e.indexOf("-")){if(n=e.split("-"),2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal range: '"+e+"'");if(o=parseInt(n[0],10)+r,i=parseInt(n[1],10)+r,isNaN(o))throw new TypeError("CronPattern: Syntax error, illegal lower range (NaN)");if(isNaN(i))throw new TypeError("CronPattern: Syntax error, illegal upper range (NaN)");if(o<0||i>=h.length)throw new TypeError("CronPattern: Value out of range: '"+e+"'");if(o>i)throw new TypeError("CronPattern: From value is larger than to value: '"+e+"'");for(s=o;s<=i;s++)h[s+r]=1}else if(-1!==e.indexOf("/")){if(n=e.split("/"),2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal stepping: '"+e+"'");if("*"!==n[0])throw new TypeError("CronPattern: Syntax error, left part of / needs to be * : '"+e+"'");if(a=parseInt(n[1],10),isNaN(a))throw new TypeError("CronPattern: Syntax error, illegal stepping: (NaN)");if(0===a)throw new TypeError("CronPattern: Syntax error, illegal stepping: 0");if(a>h.length)throw new TypeError("CronPattern: Syntax error, steps cannot be greater than maximum value of part ("+h.length+")");for(s=0;s<h.length;s+=a)h[s+r]=1}else{if(s=parseInt(e,10)+r,s<0||s>=h.length)throw new TypeError("CronPattern: "+t+" value out of range: '"+e+"'");h[s]=1}else for(s=0;s<h.length;s++)h[s]=1};const n=Math.pow(2,31)-1;function o(t,e,r){return this instanceof o?(this.pattern=new s(t),"function"==typeof e&&(r=e,e=void 0),this.options=this.processOptions(e),void 0!==r&&this.schedule(r),this):new o(t,e,r)}o.prototype.processOptions=function(t){return void 0===t&&(t={}),t.paused=void 0!==t.paused&&t.paused,t.maxRuns=void 0===t.maxRuns?1/0:t.maxRuns,t.kill=!1,t.startAt&&(t.startAt=new r(t.startAt,t.timezone)),t.stopAt&&(t.stopAt=new r(t.stopAt,t.timezone)),t},o.prototype.next=function(t){let e=this._next(t);return e?e.getDate():null},o.prototype.previous=function(){return this.previousrun?this.previousrun.getDate():null},o.prototype._next=function(t){t=new r(t,this.options.timezone),this.options.startAt&&t&&t.getTime()<this.options.startAt.getTime()&&(t=new r(this.options.startAt,this.options.timezone));let e=new r(t,this.options.timezone).increment(this.pattern);return null===e||this.options.maxRuns<=0||this.options.kill||this.options.stopAt&&e.getTime()>=this.options.stopAt.getTime()?null:e},o.prototype.msToNext=function(t){t=t||new r(void 0,this.options.timezone);let e=this._next(t);return e?e.getTime()-t.getTime():null},o.prototype.stop=function(){this.options.kill=!0,this.currentTimeout&&clearTimeout(this.currentTimeout)},o.prototype.pause=function(){return(this.options.paused=!0)&&!this.options.kill},o.prototype.resume=function(){return!(this.options.paused=!1)&&!this.options.kill},o.prototype.schedule=function(t){let e=this,s=this.msToNext(e.previousrun),o=e.maxDelay||n;return s>o&&(s=o),null!==s&&(e.currentTimeout=setTimeout((function(){s!==o&&(e.options.paused||(e.options.maxRuns--,t()),e.previousrun=new r(void 0,e.options.timezone)),e.schedule(t)}),s)),this};const i=o;var a=e.P,h=e.Z;export{a as Cron,h as default};
+var t={d:(e,r)=>{for(var n in r)t.o(r,n)&&!t.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:r[n]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};t.d(e,{P:()=>i,Z:()=>o});function r(t,e){if(this.timezone=e,t&&t instanceof Date)this.fromDate(t);else if(void 0===t)this.fromDate(new Date);else if(t&&"string"==typeof t)this.fromString(t);else{if(!(t instanceof r))throw new TypeError("CronDate: Invalid type ("+typeof t+") passed as parameter to CronDate constructor");this.fromCronDate(t)}}function n(t){this.pattern=t,this.seconds=Array(60).fill(0),this.minutes=Array(60).fill(0),this.hours=Array(24).fill(0),this.days=Array(31).fill(0),this.months=Array(12).fill(0),this.daysOfWeek=Array(8).fill(0),this.parse()}r.prototype.fromDate=function(t,e){if(this.timezone){let r=t.getTime(),n=function(t,e){return new Date(t.toLocaleString("en-US",{timeZone:e}))}(t,this.timezone);e||(t=n),this.UTCmsOffset=n.getTime()-r}else this.UTCmsOffset=0;this.milliseconds=t.getMilliseconds(),this.seconds=t.getSeconds(),this.minutes=t.getMinutes(),this.hours=t.getHours(),this.days=t.getDate(),this.months=t.getMonth(),this.years=t.getFullYear()},r.prototype.fromCronDate=function(t){this.UTCmsOffset=t.UTCmsOffset,this.timezone=t.timezone;let e=new Date(t.years,t.months,t.days,t.hours,t.minutes,t.seconds,t.milliseconds);this.milliseconds=e.getMilliseconds(),this.seconds=e.getSeconds(),this.minutes=e.getMinutes(),this.hours=e.getHours(),this.days=e.getDate(),this.months=e.getMonth(),this.years=e.getFullYear()},r.prototype.fromString=function(t){let e=this.parseISOLocal(t);if(isNaN(e))throw new TypeError("CronDate: Provided string value for CronDate could not be parsed as date.");this.fromDate(new Date(e),!0)},r.prototype.increment=function(t,e){e||(this.seconds+=1);let n=this.getTime();this.milliseconds=0;let s=this,i=function(t,e,r,n){for(let i=void 0===n?s[t]+r:0+r;i<e[t].length;i++)if(e[t][i])return s[t]=i-r,!0;return!1},o=function(){for(;p>=0;)i(a[p][0],t,a[p][2],0),p--},a=[["seconds","minutes",0],["minutes","hours",0],["hours","days",0],["days","months",-1],["months","years",0]],p=0;for(;p<5;)i(a[p][0],t,a[p][2])||(this[a[p][1]]++,o()),p++;for(;!t.daysOfWeek[this.getDate(!0).getDay()];)this.days+=1,p=2,o();return n!=s.getTime()?(s=new r(s),this.years>=4e3?null:s.increment(t,!0)):this},r.prototype.getDate=function(t){let e=t?0:this.UTCmsOffset;return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-e)},r.prototype.getTime=function(t){let e=t?0:this.UTCmsOffset;return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-e).getTime()},r.prototype.parseISOLocal=function(t){let e=t.split(/\D/);if(e.length<6)return NaN;let r=parseInt(e[0],10),n=parseInt(e[1],10),s=parseInt(e[2],10),i=parseInt(e[3],10),o=parseInt(e[4],10),a=parseInt(e[5],10);return isNaN(r)||isNaN(n)||isNaN(s)||isNaN(i)||isNaN(o)||isNaN(a)?NaN:new Date(r,n-1,s,i,o,a)},n.prototype.parse=function(){if("string"!=typeof this.pattern&&this.pattern.constructor!==String)throw new TypeError("CronPattern: Pattern has to be of type string.");let t=this.pattern.trim().replace(/\s+/g," ").split(" ");if(t.length<5||t.length>6)throw new TypeError("CronPattern: invalid configuration format ('"+this.pattern+"'), exacly five or six space separated parts required.");5===t.length&&t.unshift("0"),t[4]=this.replaceAlphaMonths(t[4]),t[5]=this.replaceAlphaDays(t[5]),this.throwAtIllegalCharacters(t),this.partToArray("seconds",t[0],0),this.partToArray("minutes",t[1],0),this.partToArray("hours",t[2],0),this.partToArray("days",t[3],-1),this.partToArray("months",t[4],-1),this.partToArray("daysOfWeek",t[5],0),this.daysOfWeek[7]&&(this.daysOfWeek[0]=1)},n.prototype.partToArray=function(t,e,r){let n,s,i=this[t];if("*"!==e)if(s=e.split(","),s.length>1)for(n=0;n<s.length;n++)this.partToArray(t,s[n],r);else-1!==e.indexOf("-")?this.handleRange(e,t,r):-1!==e.indexOf("/")?this.handleStepping(e,t,r):this.handleNumber(e,t,r);else for(n=0;n<i.length;n++)i[n]=1},n.prototype.throwAtIllegalCharacters=function(t){let e=/[^/*0-9,-]+/;for(let r=0;r<t.length;r++)if(e.test(t[r]))throw new TypeError("CronPattern: configuration entry "+r+" ("+t[r]+") contains illegal characters.")},n.prototype.handleNumber=function(t,e,r){let n=parseInt(t,10)+r;if(n<0||n>=this[e].length)throw new TypeError("CronPattern: "+e+" value out of range: '"+t+"'");this[e][n]=1},n.prototype.handleRange=function(t,e,r){let n=t.split("-");if(2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal range: '"+t+"'");let s=parseInt(n[0],10)+r,i=parseInt(n[1],10)+r;if(isNaN(s))throw new TypeError("CronPattern: Syntax error, illegal lower range (NaN)");if(isNaN(i))throw new TypeError("CronPattern: Syntax error, illegal upper range (NaN)");if(s<0||i>=this[e].length)throw new TypeError("CronPattern: Value out of range: '"+t+"'");if(s>i)throw new TypeError("CronPattern: From value is larger than to value: '"+t+"'");for(let t=s;t<=i;t++)this[e][t+r]=1},n.prototype.handleStepping=function(t,e,r){let n=t.split("/");if(2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal stepping: '"+t+"'");if("*"!==n[0])throw new TypeError("CronPattern: Syntax error, left part of / needs to be * : '"+t+"'");let s=parseInt(n[1],10);if(isNaN(s))throw new TypeError("CronPattern: Syntax error, illegal stepping: (NaN)");if(0===s)throw new TypeError("CronPattern: Syntax error, illegal stepping: 0");if(s>this[e].length)throw new TypeError("CronPattern: Syntax error, steps cannot be greater than maximum value of part ("+this[e].length+")");for(let t=0;t<this[e].length;t+=s)this[e][t+r]=1},n.prototype.replaceAlphaDays=function(t){return t.replace(/sun/gi,"0").replace(/mon/gi,"1").replace(/tue/gi,"2").replace(/wed/gi,"3").replace(/thu/gi,"4").replace(/fri/gi,"5").replace(/sat/gi,"6")},n.prototype.replaceAlphaMonths=function(t){return t.replace(/jan/gi,"1").replace(/feb/gi,"2").replace(/mar/gi,"3").replace(/apr/gi,"4").replace(/may/gi,"5").replace(/jun/gi,"6").replace(/jul/gi,"7").replace(/aug/gi,"8").replace(/sep/gi,"9").replace(/oct/gi,"10").replace(/nov/gi,"11").replace(/dec/gi,"12")};const s=Math.pow(2,31)-1;function i(t,e,r){return this instanceof i?(this.pattern=new n(t),"function"==typeof e&&(r=e,e=void 0),this.options=this.processOptions(e),void 0!==r&&this.schedule(r),this):new i(t,e,r)}i.prototype.processOptions=function(t){return void 0===t&&(t={}),t.paused=void 0!==t.paused&&t.paused,t.maxRuns=void 0===t.maxRuns?1/0:t.maxRuns,t.kill=!1,t.startAt&&(t.startAt=new r(t.startAt,t.timezone)),t.stopAt&&(t.stopAt=new r(t.stopAt,t.timezone)),t},i.prototype.next=function(t){t=new r(t,this.options.timezone);let e=this._next(t);return e?e.getDate():null},i.prototype.previous=function(){return this.previousrun?this.previousrun.getDate():null},i.prototype._next=function(t){this.options.startAt&&t&&t.getTime(!0)<this.options.startAt.getTime(!0)&&(t=new r(this.options.startAt,this.options.timezone));let e=new r(t,this.options.timezone).increment(this.pattern);return null===e||this.options.maxRuns<=0||this.options.kill||this.options.stopAt&&e.getTime(!0)>=this.options.stopAt.getTime(!0)?null:e},i.prototype.msToNext=function(t){t=new r(t,this.options.timezone);let e=this._next(t);return e?e.getTime(!0)-t.getTime(!0):null},i.prototype.stop=function(){this.options.kill=!0,this.currentTimeout&&clearTimeout(this.currentTimeout)},i.prototype.pause=function(){return(this.options.paused=!0)&&!this.options.kill},i.prototype.resume=function(){return!(this.options.paused=!1)&&!this.options.kill},i.prototype.schedule=function(t){let e=this,n=this.msToNext(e.previousrun),i=e.maxDelay||s;return n>i&&(n=i),null!==n&&(e.currentTimeout=setTimeout((function(){n!==i&&(e.options.paused||(e.options.maxRuns--,t()),e.previousrun=new r(void 0,e.options.timezone)),e.schedule(t)}),n)),this};const o=i;var a=e.P,p=e.Z;export{a as Cron,p as default};

package/dist-legacy/croner.cjs

@@ -1 +1 @@
-!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.Cron=e():t.Cron=e()}(this,(function(){return(()=>{"use strict";var t={d:(e,r)=>{for(var o in r)t.o(r,o)&&!t.o(e,o)&&Object.defineProperty(e,o,{enumerable:!0,get:r[o]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};t.d(e,{default:()=>i});function r(t,e){if(this.timezone=e,t&&t instanceof Date)this.fromDate(t);else if(void 0===t)this.fromDate(new Date);else if(t&&"string"==typeof t)this.fromString(t);else{if(!(t instanceof r))throw new TypeError("CronDate: Invalid type ("+typeof t+") passed as parameter to CronDate constructor");this.fromCronDate(t)}}function o(t){this.pattern=t,this.seconds=Array(60).fill(0),this.minutes=Array(60).fill(0),this.hours=Array(24).fill(0),this.days=Array(31).fill(0),this.months=Array(12).fill(0),this.daysOfWeek=Array(8).fill(0),this.parse()}r.prototype.fromDate=function(t){let e=t.getTime();this.timezone&&(t=function(t,e){return new Date(t.toLocaleString("en-US",{timeZone:e}))}(t,this.timezone));let r=t.getTime();this.UTCmsOffset=r-e,this.milliseconds=t.getMilliseconds(),this.seconds=t.getSeconds(),this.minutes=t.getMinutes(),this.hours=t.getHours(),this.days=t.getDate(),this.months=t.getMonth(),this.years=t.getFullYear()},r.prototype.fromCronDate=function(t){this.UTCmsOffset=t.UTCmsOffset,this.timezone=t.timezone;let e=new Date(t.years,t.months,t.days,t.hours,t.minutes,t.seconds,t.milliseconds);this.milliseconds=e.getMilliseconds(),this.seconds=e.getSeconds(),this.minutes=e.getMinutes(),this.hours=e.getHours(),this.days=e.getDate(),this.months=e.getMonth(),this.years=e.getFullYear()},r.prototype.fromString=function(t){let e=Date.parse(t);if(isNaN(e))throw new TypeError("CronDate: Provided string value for CronDate could not be parsed as date.");this.fromDate(new Date(e))},r.prototype.increment=function(t,e){e||(this.seconds+=1);let o=this.getTime();this.milliseconds=0;let n=this,s=function(t,e,r,o){for(let s=void 0===o?n[t]+r:0+r;s<e[t].length;s++)if(e[t][s])return n[t]=s-r,!0;return!1},i=function(){for(;h>=0;)s(a[h][0],t,a[h][2],0),h--},a=[["seconds","minutes",0],["minutes","hours",0],["hours","days",0],["days","months",-1],["months","years",0]],h=0;for(;h<5;)s(a[h][0],t,a[h][2])||(this[a[h][1]]++,i()),h++;for(;!t.daysOfWeek[this.getDate().getDay()];)this.days+=1,h=2,i();return o!=n.getTime()?(n=new r(n),this.years>=4e3?null:n.increment(t,!0)):this},r.prototype.getDate=function(){return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-this.UTCmsOffset)},r.prototype.getTime=function(){return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-this.UTCmsOffset).getTime()},o.prototype.parse=function(){if("string"!=typeof this.pattern&&this.pattern.constructor!==String)throw new TypeError("CronPattern: Pattern has to be of type string.");let t,e,r=this.pattern.trim().replace(/\s+/g," ").split(" "),o=/[^/*0-9,-]+/;if(r.length<5||r.length>6)throw new TypeError("CronPattern: invalid configuration format ('"+this.pattern+"'), exacly five or six space separated parts required.");for(5===r.length&&r.unshift("0"),e=0;e<r.length;e++)if(t=r[e].trim(),o.test(t))throw new TypeError("CronPattern: configuration entry "+(e+1)+" ("+t+") contains illegal characters.");this.partToArray("seconds",r[0],0),this.partToArray("minutes",r[1],0),this.partToArray("hours",r[2],0),this.partToArray("days",r[3],-1),this.partToArray("months",r[4],-1),this.partToArray("daysOfWeek",r[5],0),this.daysOfWeek[7]&&(this.daysOfWeek[0]=1)},o.prototype.partToArray=function(t,e,r){let o,n,s,i,a,h=this[t];if("*"!==e)if(n=e.split(","),n.length>1)for(o=0;o<n.length;o++)this.partToArray(t,n[o],r);else if(-1!==e.indexOf("-")){if(n=e.split("-"),2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal range: '"+e+"'");if(s=parseInt(n[0],10)+r,i=parseInt(n[1],10)+r,isNaN(s))throw new TypeError("CronPattern: Syntax error, illegal lower range (NaN)");if(isNaN(i))throw new TypeError("CronPattern: Syntax error, illegal upper range (NaN)");if(s<0||i>=h.length)throw new TypeError("CronPattern: Value out of range: '"+e+"'");if(s>i)throw new TypeError("CronPattern: From value is larger than to value: '"+e+"'");for(o=s;o<=i;o++)h[o+r]=1}else if(-1!==e.indexOf("/")){if(n=e.split("/"),2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal stepping: '"+e+"'");if("*"!==n[0])throw new TypeError("CronPattern: Syntax error, left part of / needs to be * : '"+e+"'");if(a=parseInt(n[1],10),isNaN(a))throw new TypeError("CronPattern: Syntax error, illegal stepping: (NaN)");if(0===a)throw new TypeError("CronPattern: Syntax error, illegal stepping: 0");if(a>h.length)throw new TypeError("CronPattern: Syntax error, steps cannot be greater than maximum value of part ("+h.length+")");for(o=0;o<h.length;o+=a)h[o+r]=1}else{if(o=parseInt(e,10)+r,o<0||o>=h.length)throw new TypeError("CronPattern: "+t+" value out of range: '"+e+"'");h[o]=1}else for(o=0;o<h.length;o++)h[o]=1};const n=Math.pow(2,31)-1;function s(t,e,r){return this instanceof s?(this.pattern=new o(t),"function"==typeof e&&(r=e,e=void 0),this.options=this.processOptions(e),void 0!==r&&this.schedule(r),this):new s(t,e,r)}s.prototype.processOptions=function(t){return void 0===t&&(t={}),t.paused=void 0!==t.paused&&t.paused,t.maxRuns=void 0===t.maxRuns?1/0:t.maxRuns,t.kill=!1,t.startAt&&(t.startAt=new r(t.startAt,t.timezone)),t.stopAt&&(t.stopAt=new r(t.stopAt,t.timezone)),t},s.prototype.next=function(t){let e=this._next(t);return e?e.getDate():null},s.prototype.previous=function(){return this.previousrun?this.previousrun.getDate():null},s.prototype._next=function(t){t=new r(t,this.options.timezone),this.options.startAt&&t&&t.getTime()<this.options.startAt.getTime()&&(t=new r(this.options.startAt,this.options.timezone));let e=new r(t,this.options.timezone).increment(this.pattern);return null===e||this.options.maxRuns<=0||this.options.kill||this.options.stopAt&&e.getTime()>=this.options.stopAt.getTime()?null:e},s.prototype.msToNext=function(t){t=t||new r(void 0,this.options.timezone);let e=this._next(t);return e?e.getTime()-t.getTime():null},s.prototype.stop=function(){this.options.kill=!0,this.currentTimeout&&clearTimeout(this.currentTimeout)},s.prototype.pause=function(){return(this.options.paused=!0)&&!this.options.kill},s.prototype.resume=function(){return!(this.options.paused=!1)&&!this.options.kill},s.prototype.schedule=function(t){let e=this,o=this.msToNext(e.previousrun),s=e.maxDelay||n;return o>s&&(o=s),null!==o&&(e.currentTimeout=setTimeout((function(){o!==s&&(e.options.paused||(e.options.maxRuns--,t()),e.previousrun=new r(void 0,e.options.timezone)),e.schedule(t)}),o)),this};const i=s;return e.default})()}));
+!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.Cron=e():t.Cron=e()}(this,(function(){return(()=>{"use strict";var t={d:(e,r)=>{for(var n in r)t.o(r,n)&&!t.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:r[n]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};t.d(e,{default:()=>o});function r(t,e){if(this.timezone=e,t&&t instanceof Date)this.fromDate(t);else if(void 0===t)this.fromDate(new Date);else if(t&&"string"==typeof t)this.fromString(t);else{if(!(t instanceof r))throw new TypeError("CronDate: Invalid type ("+typeof t+") passed as parameter to CronDate constructor");this.fromCronDate(t)}}function n(t){this.pattern=t,this.seconds=Array(60).fill(0),this.minutes=Array(60).fill(0),this.hours=Array(24).fill(0),this.days=Array(31).fill(0),this.months=Array(12).fill(0),this.daysOfWeek=Array(8).fill(0),this.parse()}r.prototype.fromDate=function(t,e){if(this.timezone){let r=t.getTime(),n=function(t,e){return new Date(t.toLocaleString("en-US",{timeZone:e}))}(t,this.timezone);e||(t=n),this.UTCmsOffset=n.getTime()-r}else this.UTCmsOffset=0;this.milliseconds=t.getMilliseconds(),this.seconds=t.getSeconds(),this.minutes=t.getMinutes(),this.hours=t.getHours(),this.days=t.getDate(),this.months=t.getMonth(),this.years=t.getFullYear()},r.prototype.fromCronDate=function(t){this.UTCmsOffset=t.UTCmsOffset,this.timezone=t.timezone;let e=new Date(t.years,t.months,t.days,t.hours,t.minutes,t.seconds,t.milliseconds);this.milliseconds=e.getMilliseconds(),this.seconds=e.getSeconds(),this.minutes=e.getMinutes(),this.hours=e.getHours(),this.days=e.getDate(),this.months=e.getMonth(),this.years=e.getFullYear()},r.prototype.fromString=function(t){let e=this.parseISOLocal(t);if(isNaN(e))throw new TypeError("CronDate: Provided string value for CronDate could not be parsed as date.");this.fromDate(new Date(e),!0)},r.prototype.increment=function(t,e){e||(this.seconds+=1);let n=this.getTime();this.milliseconds=0;let i=this,s=function(t,e,r,n){for(let s=void 0===n?i[t]+r:0+r;s<e[t].length;s++)if(e[t][s])return i[t]=s-r,!0;return!1},o=function(){for(;p>=0;)s(a[p][0],t,a[p][2],0),p--},a=[["seconds","minutes",0],["minutes","hours",0],["hours","days",0],["days","months",-1],["months","years",0]],p=0;for(;p<5;)s(a[p][0],t,a[p][2])||(this[a[p][1]]++,o()),p++;for(;!t.daysOfWeek[this.getDate(!0).getDay()];)this.days+=1,p=2,o();return n!=i.getTime()?(i=new r(i),this.years>=4e3?null:i.increment(t,!0)):this},r.prototype.getDate=function(t){let e=t?0:this.UTCmsOffset;return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-e)},r.prototype.getTime=function(t){let e=t?0:this.UTCmsOffset;return new Date(this.years,this.months,this.days,this.hours,this.minutes,this.seconds,this.milliseconds-e).getTime()},r.prototype.parseISOLocal=function(t){let e=t.split(/\D/);if(e.length<6)return NaN;let r=parseInt(e[0],10),n=parseInt(e[1],10),i=parseInt(e[2],10),s=parseInt(e[3],10),o=parseInt(e[4],10),a=parseInt(e[5],10);return isNaN(r)||isNaN(n)||isNaN(i)||isNaN(s)||isNaN(o)||isNaN(a)?NaN:new Date(r,n-1,i,s,o,a)},n.prototype.parse=function(){if("string"!=typeof this.pattern&&this.pattern.constructor!==String)throw new TypeError("CronPattern: Pattern has to be of type string.");let t=this.pattern.trim().replace(/\s+/g," ").split(" ");if(t.length<5||t.length>6)throw new TypeError("CronPattern: invalid configuration format ('"+this.pattern+"'), exacly five or six space separated parts required.");5===t.length&&t.unshift("0"),t[4]=this.replaceAlphaMonths(t[4]),t[5]=this.replaceAlphaDays(t[5]),this.throwAtIllegalCharacters(t),this.partToArray("seconds",t[0],0),this.partToArray("minutes",t[1],0),this.partToArray("hours",t[2],0),this.partToArray("days",t[3],-1),this.partToArray("months",t[4],-1),this.partToArray("daysOfWeek",t[5],0),this.daysOfWeek[7]&&(this.daysOfWeek[0]=1)},n.prototype.partToArray=function(t,e,r){let n,i,s=this[t];if("*"!==e)if(i=e.split(","),i.length>1)for(n=0;n<i.length;n++)this.partToArray(t,i[n],r);else-1!==e.indexOf("-")?this.handleRange(e,t,r):-1!==e.indexOf("/")?this.handleStepping(e,t,r):this.handleNumber(e,t,r);else for(n=0;n<s.length;n++)s[n]=1},n.prototype.throwAtIllegalCharacters=function(t){let e=/[^/*0-9,-]+/;for(let r=0;r<t.length;r++)if(e.test(t[r]))throw new TypeError("CronPattern: configuration entry "+r+" ("+t[r]+") contains illegal characters.")},n.prototype.handleNumber=function(t,e,r){let n=parseInt(t,10)+r;if(n<0||n>=this[e].length)throw new TypeError("CronPattern: "+e+" value out of range: '"+t+"'");this[e][n]=1},n.prototype.handleRange=function(t,e,r){let n=t.split("-");if(2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal range: '"+t+"'");let i=parseInt(n[0],10)+r,s=parseInt(n[1],10)+r;if(isNaN(i))throw new TypeError("CronPattern: Syntax error, illegal lower range (NaN)");if(isNaN(s))throw new TypeError("CronPattern: Syntax error, illegal upper range (NaN)");if(i<0||s>=this[e].length)throw new TypeError("CronPattern: Value out of range: '"+t+"'");if(i>s)throw new TypeError("CronPattern: From value is larger than to value: '"+t+"'");for(let t=i;t<=s;t++)this[e][t+r]=1},n.prototype.handleStepping=function(t,e,r){let n=t.split("/");if(2!==n.length)throw new TypeError("CronPattern: Syntax error, illegal stepping: '"+t+"'");if("*"!==n[0])throw new TypeError("CronPattern: Syntax error, left part of / needs to be * : '"+t+"'");let i=parseInt(n[1],10);if(isNaN(i))throw new TypeError("CronPattern: Syntax error, illegal stepping: (NaN)");if(0===i)throw new TypeError("CronPattern: Syntax error, illegal stepping: 0");if(i>this[e].length)throw new TypeError("CronPattern: Syntax error, steps cannot be greater than maximum value of part ("+this[e].length+")");for(let t=0;t<this[e].length;t+=i)this[e][t+r]=1},n.prototype.replaceAlphaDays=function(t){return t.replace(/sun/gi,"0").replace(/mon/gi,"1").replace(/tue/gi,"2").replace(/wed/gi,"3").replace(/thu/gi,"4").replace(/fri/gi,"5").replace(/sat/gi,"6")},n.prototype.replaceAlphaMonths=function(t){return t.replace(/jan/gi,"1").replace(/feb/gi,"2").replace(/mar/gi,"3").replace(/apr/gi,"4").replace(/may/gi,"5").replace(/jun/gi,"6").replace(/jul/gi,"7").replace(/aug/gi,"8").replace(/sep/gi,"9").replace(/oct/gi,"10").replace(/nov/gi,"11").replace(/dec/gi,"12")};const i=Math.pow(2,31)-1;function s(t,e,r){return this instanceof s?(this.pattern=new n(t),"function"==typeof e&&(r=e,e=void 0),this.options=this.processOptions(e),void 0!==r&&this.schedule(r),this):new s(t,e,r)}s.prototype.processOptions=function(t){return void 0===t&&(t={}),t.paused=void 0!==t.paused&&t.paused,t.maxRuns=void 0===t.maxRuns?1/0:t.maxRuns,t.kill=!1,t.startAt&&(t.startAt=new r(t.startAt,t.timezone)),t.stopAt&&(t.stopAt=new r(t.stopAt,t.timezone)),t},s.prototype.next=function(t){t=new r(t,this.options.timezone);let e=this._next(t);return e?e.getDate():null},s.prototype.previous=function(){return this.previousrun?this.previousrun.getDate():null},s.prototype._next=function(t){this.options.startAt&&t&&t.getTime(!0)<this.options.startAt.getTime(!0)&&(t=new r(this.options.startAt,this.options.timezone));let e=new r(t,this.options.timezone).increment(this.pattern);return null===e||this.options.maxRuns<=0||this.options.kill||this.options.stopAt&&e.getTime(!0)>=this.options.stopAt.getTime(!0)?null:e},s.prototype.msToNext=function(t){t=new r(t,this.options.timezone);let e=this._next(t);return e?e.getTime(!0)-t.getTime(!0):null},s.prototype.stop=function(){this.options.kill=!0,this.currentTimeout&&clearTimeout(this.currentTimeout)},s.prototype.pause=function(){return(this.options.paused=!0)&&!this.options.kill},s.prototype.resume=function(){return!(this.options.paused=!1)&&!this.options.kill},s.prototype.schedule=function(t){let e=this,n=this.msToNext(e.previousrun),s=e.maxDelay||i;return n>s&&(n=s),null!==n&&(e.currentTimeout=setTimeout((function(){n!==s&&(e.options.paused||(e.options.maxRuns--,t()),e.previousrun=new r(void 0,e.options.timezone)),e.schedule(t)}),n)),this};const o=s;return e.default})()}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "croner",
-  "version": "4.0.53",
+  "version": "4.0.57",
   "description": "Trigger functions in javascript using Cron syntax. No deps. All features.",
   "author": "Hexagon <github.com/hexagon>",
   "contributors": [

package/src/croner.js

@@ -152,14 +152,16 @@ Cron.prototype.processOptions = function (options) {
  * @returns {Date | null} - Next run time
  */
 Cron.prototype.next = function (prev) {
+	prev = new CronDate(prev, this.options.timezone);
 	let next = this._next(prev);
 	return next ? next.getDate() : null;
 };
 
 /**
  * Return previous run time
+ * @public
  * 
- * @returns {Date | null} - Previous run time
+ * @returns {CronDate | null} - Previous run time
  */
 Cron.prototype.previous = function () {
 	return this.previousrun ? this.previousrun.getDate() : null;
@@ -169,26 +171,23 @@ Cron.prototype.previous = function () {
  * Internal version of next. Cron needs millseconds internally, hence _next.
  * @private
  * 
- * @param {Date} prev - Input pattern
+ * @param {CronDate} prev - Input pattern
  * @returns {CronDate | null} - Next run time
  */
 Cron.prototype._next = function (prev) {
 
-	prev = new CronDate(prev, this.options.timezone);
-
 	// Previous run should never be before startAt
-	if( this.options.startAt && prev && prev.getTime() < this.options.startAt.getTime() ) {
+	if( this.options.startAt && prev && prev.getTime(true) < this.options.startAt.getTime(true) ) {
 		prev = new CronDate(this.options.startAt, this.options.timezone);
 	}
 
 	// Calculate next run
 	let nextRun = new CronDate(prev, this.options.timezone).increment(this.pattern);
 
-	// Check for stop condition
 	if ((nextRun === null) ||
 		(this.options.maxRuns <= 0) ||	
 		(this.options.kill) ||
-		(this.options.stopAt && nextRun.getTime() >= this.options.stopAt.getTime() )) {
+		(this.options.stopAt && nextRun.getTime(true) >= this.options.stopAt.getTime(true) )) {
 		return null;
 	} else {
 		// All seem good, return next run
@@ -199,15 +198,16 @@ Cron.prototype._next = function (prev) {
 
 /**
  * Returns number of milliseconds to next run
+ * @public
  * 
  * @param {CronNextResult} [prev=new CronDate()] - Starting date, defaults to now
  * @returns {number | null}
  */
 Cron.prototype.msToNext = function (prev) {
-	prev = prev || new CronDate(void 0, this.options.timezone);
+	prev = new CronDate(prev, this.options.timezone);
 	let next = this._next(prev);
 	if( next ) {
-		return (next.getTime() - prev.getTime());
+		return (next.getTime(true) - prev.getTime(true));
 	} else {
 		return null;
 	}
@@ -226,7 +226,7 @@ Cron.prototype.stop = function () {
 };
 
 /**
- * Pause execution
+ * Pause executionR
  * @public
  * 
  * @returns {boolean} - Wether pause was successful
@@ -283,7 +283,7 @@ Cron.prototype.schedule = function (func) {
 				self.previousrun = new CronDate(void 0, self.options.timezone);
 			}
 
-			// Recurseg
+			// Recurse
 			self.schedule(func);
 
 		}, waitMs );

package/src/date.js

@@ -1,10 +1,9 @@
 import convertTZ from "./timezone.js";
-
 /**
  * Converts date to CronDate
  * @constructor
  * 
- * @param {date|string} [date] - Input date
+ * @param {date|string} [date] - Input date, if using string representation ISO 8001 (2015-11-24T19:40:00) local timezone is expected
  * @param {string} [timezone] - String representation of timezone in Europe/Stockholm format.
  */
 function CronDate (date, timezone) {	
@@ -29,17 +28,22 @@ function CronDate (date, timezone) {
  * @private
  * 
  * @param {date} date - Input date
+ * @param {boolean} [fromLocal] - Input date already in target timezone
  */
-CronDate.prototype.fromDate = function (date) {
+CronDate.prototype.fromDate = function (date, fromLocal) {
 
 
 	// This is the only way in for a pure date object, so this is where timezone should be applied
-	let originalUTCms = date.getTime();
 	if (this.timezone) {
-		date = convertTZ(date, this.timezone);
+		let originalUTCms = date.getTime(),
+			convertedDate = convertTZ(date, this.timezone);
+		if (!fromLocal) {
+			date = convertedDate;
+		}
+		this.UTCmsOffset = convertedDate.getTime() - originalUTCms;
+	} else {
+		this.UTCmsOffset = 0;
 	}
-	let convertedUTCms = date.getTime();
-	this.UTCmsOffset = convertedUTCms - originalUTCms;
 
 	this.milliseconds = date.getMilliseconds();
 	this.seconds = date.getSeconds();
@@ -82,14 +86,14 @@ CronDate.prototype.fromCronDate = function (date) {
  */
 CronDate.prototype.fromString = function (str) {
 
-	let parsedDateUTCms = Date.parse(str);
+	let parsedDateUTCms = this.parseISOLocal(str);
 
 	// Throw if we did get an invalid date
 	if( isNaN(parsedDateUTCms) ) {
 		throw new TypeError("CronDate: Provided string value for CronDate could not be parsed as date.");
 	}
 	
-	this.fromDate(new Date(parsedDateUTCms));
+	this.fromDate(new Date(parsedDateUTCms), true);
 };
 
 /**
@@ -194,7 +198,7 @@ CronDate.prototype.increment = function (pattern, rerun) {
 
 	// This is a special case for weekday, as the user isn't able to combine date/month patterns 
 	// with weekday patterns, it's just to increment days until we get a match.
-	while (!pattern.daysOfWeek[this.getDate().getDay()]) {
+	while (!pattern.daysOfWeek[this.getDate(true).getDay()]) {
 		this.days += 1;
 		doing = 2;
 		resetPrevious();
@@ -219,22 +223,57 @@ CronDate.prototype.increment = function (pattern, rerun) {
  * Convert current state back to a javascript Date()
  * @public
  * 
+ * @param {boolean} internal - If this is an internal call
  * @returns {date}
  * 
  */
-CronDate.prototype.getDate = function () {
-	return new Date(this.years, this.months, this.days, this.hours, this.minutes, this.seconds, this.milliseconds-this.UTCmsOffset);
+CronDate.prototype.getDate = function (internal) {
+	let offset = internal ? 0 : this.UTCmsOffset;
+	return new Date(this.years, this.months, this.days, this.hours, this.minutes, this.seconds, this.milliseconds-offset);
 };
 
 /**
  * Convert current state back to a javascript Date() and return UTC milliseconds
  * @public
- * 
+ * @param {boolean} internal - If this is an internal call
  * @returns {date}
  * 
  */
-CronDate.prototype.getTime = function () {
-	return new Date(this.years, this.months, this.days, this.hours, this.minutes, this.seconds, this.milliseconds-this.UTCmsOffset).getTime();
+CronDate.prototype.getTime = function (internal) {
+	let offset = internal ? 0 : this.UTCmsOffset;
+	return new Date(this.years, this.months, this.days, this.hours, this.minutes, this.seconds, this.milliseconds-offset).getTime();
+};
+
+/**
+ * parseISOLocal
+ * @private
+ * 
+ * @param {string} s - an ISO 8001 format date and time string
+ *                      with all components, e.g. 2015-11-24T19:40:00
+ * @returns {Date|number} - Date instance from parsing the string. May be NaN.
+ */
+CronDate.prototype.parseISOLocal = function (s) {
+	let b = s.split(/\D/);
+
+	// Check for completeness
+	if (b.length < 6) {
+		return NaN;
+	}
+
+	let
+		year = parseInt(b[0], 10),
+		month = parseInt(b[1], 10),
+		day = parseInt(b[2], 10),
+		hour = parseInt(b[3], 10),
+		minute = parseInt(b[4], 10),
+		second = parseInt(b[5], 10);
+
+	// Check parts for numeric
+	if( isNaN(year) || isNaN(month) || isNaN(day) || isNaN(hour) || isNaN(minute) || isNaN(second) ) {
+		return NaN;
+	} else {
+		return new Date(year, month-1, day, hour, minute, second);
+	}
 };
 
 export { CronDate };

package/src/pattern.js

@@ -25,6 +25,7 @@ function CronPattern (pattern) {
 
 /**
  * Parse current pattern, will raise an error on failure
+ * @private
  */
 CronPattern.prototype.parse = function () {
 
@@ -34,10 +35,7 @@ CronPattern.prototype.parse = function () {
 	}
 
 	// Split configuration on whitespace
-	let parts = this.pattern.trim().replace(/\s+/g, " ").split(" "),
-		part,
-		i,
-		reValidCron = /[^/*0-9,-]+/;
+	let parts = this.pattern.trim().replace(/\s+/g, " ").split(" ");
 
 	// Validite number of configuration entries
 	if( parts.length < 5 || parts.length > 6 ) {
@@ -49,15 +47,13 @@ CronPattern.prototype.parse = function () {
 		parts.unshift("0");
 	}
 
-	// Validate field content
-	for( i = 0; i < parts.length; i++ ) {
-		part = parts[i].trim();
+	
+	// Replace alpha representations
+	parts[4] = this.replaceAlphaMonths(parts[4]);
+	parts[5] = this.replaceAlphaDays(parts[5]);
 
-		// Check that part only contain legal characters ^[0-9-,]+$
-		if( reValidCron.test(part) ) {
-			throw new TypeError("CronPattern: configuration entry " + (i + 1) + " (" + part + ") contains illegal characters.");
-		}
-	}
+	// Check part content
+	this.throwAtIllegalCharacters(parts);
 
 	// Parse parts into arrays, validates as we go
 	this.partToArray("seconds",    parts[0], 0);
@@ -76,6 +72,7 @@ CronPattern.prototype.parse = function () {
 
 /**
  * Convert current part (seconds/minutes etc) to an array of 1 or 0 depending on if the part is about to trigger a run or not.
+ * @private
  * 
  * @param {CronPatternPart} type - Seconds/minutes etc
  * @param {string} conf - Current pattern part - *, 0-1 etc
@@ -85,9 +82,6 @@ CronPattern.prototype.partToArray = function (type, conf, valueIndexOffset) {
 
 	let i,
 		split,
-		lower,
-		upper,
-		steps,
 		arr = this[type];
 
 	// First off, handle wildcard
@@ -98,92 +92,174 @@ CronPattern.prototype.partToArray = function (type, conf, valueIndexOffset) {
 		return;
 	}
 
-	// Recurse into comma separated entries
+	// Handle separated entries (,) by recursion
 	split = conf.split(",");
 	if( split.length > 1 ) {
 		for( i = 0; i < split.length; i++ ) {
 			this.partToArray(type, split[i], valueIndexOffset);
 		}
-	
-		return;
-	}
 
-	// Didn't need to recurse, determine if this is a range, steps or a number
-	// - Got a range
-	if( conf.indexOf("-") !== -1 ) {
+	// Handle range (-)
+	} else if( conf.indexOf("-") !== -1 ) {
+		this.handleRange(conf, type, valueIndexOffset);
 
-		split = conf.split("-");
+	// Handle stepping (/)
+	} else if( conf.indexOf("/") !== -1 ) {
+		this.handleStepping(conf, type, valueIndexOffset);
 
-		if( split.length !== 2 ) {
-			throw new TypeError("CronPattern: Syntax error, illegal range: '" + conf + "'");
-		}
+	// Handle pure number
+	} else {
+		this.handleNumber(conf, type, valueIndexOffset);
+	}
 
-		lower = parseInt(split[0], 10) + valueIndexOffset;
-		upper = parseInt(split[1], 10) + valueIndexOffset;
+};
 
-		if( isNaN(lower) ) {
-			throw new TypeError("CronPattern: Syntax error, illegal lower range (NaN)");
-		} else if( isNaN(upper) ) {
-			throw new TypeError("CronPattern: Syntax error, illegal upper range (NaN)");
+/**
+ * After converting JAN-DEC, SUN-SAT only 0-9 * , / - are allowed, throw if anything else pops up
+ * @private
+ * 
+ * @param {string[]} parts - Each part split as strings
+ */
+CronPattern.prototype.throwAtIllegalCharacters = function (parts) {
+	let reValidCron = /[^/*0-9,-]+/;
+	for(let i = 0; i < parts.length; i++) {
+		if( reValidCron.test(parts[i]) ) {
+			throw new TypeError("CronPattern: configuration entry " + i + " (" + parts[i] + ") contains illegal characters.");
 		}
+	}
+};
 
-		// Check that value is within range
-		if( lower < 0 || upper >= arr.length ) {
-			throw new TypeError("CronPattern: Value out of range: '" + conf + "'");
-		}
+/**
+ * Nothing but a number left, handle that
+ * @private
+ * 
+ * @param {string} conf - Current part, expected to be a number, as a string
+ * @param {string} type - One of "seconds", "minutes" etc
+ * @param {number} valueIndexOffset - -1 for day of month, and month, as they start at 1. 0 for seconds, hours, minutes
+ */
+CronPattern.prototype.handleNumber = function (conf, type, valueIndexOffset) {
+	let i = (parseInt(conf, 10) + valueIndexOffset);
 
-		//
-		if( lower > upper ) {
-			throw new TypeError("CronPattern: From value is larger than to value: '" + conf + "'");
-		}
+	if( i < 0 || i >= this[type].length ) {
+		throw new TypeError("CronPattern: " + type + " value out of range: '" + conf + "'");
+	}
 
-		for( i = lower; i <= upper; i++ ) {
-			arr[(i + valueIndexOffset)] = 1;
-		}
+	this[type][i] = 1;
+};
 
-	// - Got stepping
-	} else if( conf.indexOf("/") !== -1 ) {
-		
-		split = conf.split("/");
 
-		if( split.length !== 2 ) {
-			throw new TypeError("CronPattern: Syntax error, illegal stepping: '" + conf + "'");
-		}
+/**
+ * Take care of ranges (e.g. 1-20)
+ * @private
+ * 
+ * @param {string} conf - Current part, expected to be a string like 1-20
+ * @param {string} type - One of "seconds", "minutes" etc
+ * @param {number} valueIndexOffset - -1 for day of month, and month, as they start at 1. 0 for seconds, hours, minutes
+ */
+CronPattern.prototype.handleRange = function (conf, type, valueIndexOffset) {
+	let split = conf.split("-");
 
-		if( split[0] !== "*" ) {
-			throw new TypeError("CronPattern: Syntax error, left part of / needs to be * : '" + conf + "'");
-		}
+	if( split.length !== 2 ) {
+		throw new TypeError("CronPattern: Syntax error, illegal range: '" + conf + "'");
+	}
 
-		steps = parseInt(split[1], 10);
+	let lower = parseInt(split[0], 10) + valueIndexOffset,
+		upper = parseInt(split[1], 10) + valueIndexOffset;
 
-		if( isNaN(steps) ) {
-			throw new TypeError("CronPattern: Syntax error, illegal stepping: (NaN)");
-		}
+	if( isNaN(lower) ) {
+		throw new TypeError("CronPattern: Syntax error, illegal lower range (NaN)");
+	} else if( isNaN(upper) ) {
+		throw new TypeError("CronPattern: Syntax error, illegal upper range (NaN)");
+	}
 
-		if( steps === 0 ) {
-			throw new TypeError("CronPattern: Syntax error, illegal stepping: 0");
-		}
+	// Check that value is within range
+	if( lower < 0 || upper >= this[type].length ) {
+		throw new TypeError("CronPattern: Value out of range: '" + conf + "'");
+	}
 
-		if( steps > arr.length ) {
-			throw new TypeError("CronPattern: Syntax error, steps cannot be greater than maximum value of part ("+arr.length+")");
-		}
+	//
+	if( lower > upper ) {
+		throw new TypeError("CronPattern: From value is larger than to value: '" + conf + "'");
+	}
 
-		for( i = 0; i < arr.length; i+= steps ) {
-			arr[(i + valueIndexOffset)] = 1;
-		}
+	for( let i = lower; i <= upper; i++ ) {
+		this[type][(i + valueIndexOffset)] = 1;
+	}
+};
 
-	// - Got a number
-	} else {
+/**
+ * Handle stepping (e.g. * / 14)
+ * @private
+ * 
+ * @param {string} conf - Current part, expected to be a string like * /20 (without the space)
+ * @param {string} type - One of "seconds", "minutes" etc
+ * @param {number} valueIndexOffset - -1 for day of month, and month, as they start at 1. 0 for seconds, hours, minutes
+ */
+CronPattern.prototype.handleStepping = function (conf, type, valueIndexOffset) {
 
-		i = (parseInt(conf, 10) + valueIndexOffset);
+	let split = conf.split("/");
 
-		if( i < 0 || i >= arr.length ) {
-			throw new TypeError("CronPattern: " + type + " value out of range: '" + conf + "'");
-		}
+	if( split.length !== 2 ) {
+		throw new TypeError("CronPattern: Syntax error, illegal stepping: '" + conf + "'");
+	}
 
-		arr[i] = 1;
+	if( split[0] !== "*" ) {
+		throw new TypeError("CronPattern: Syntax error, left part of / needs to be * : '" + conf + "'");
 	}
 
+	let steps = parseInt(split[1], 10);
+
+	if( isNaN(steps) ) throw new TypeError("CronPattern: Syntax error, illegal stepping: (NaN)");
+	if( steps === 0 ) throw new TypeError("CronPattern: Syntax error, illegal stepping: 0");
+	if( steps > this[type].length ) throw new TypeError("CronPattern: Syntax error, steps cannot be greater than maximum value of part ("+this[type].length+")");
+
+	for( let i = 0; i < this[type].length; i+= steps ) {
+		this[type][(i + valueIndexOffset)] = 1;
+	}
+};
+
+
+/**
+ * Replace day name with day numbers
+ * @private
+ * 
+ * @param {string} conf - Current part, expected to be a string that might contain sun,mon etc.
+ * 
+ * @returns {string} - conf with 0 instead of sun etc.
+ */
+CronPattern.prototype.replaceAlphaDays = function (conf) {
+	return conf
+		.replace(/sun/gi, "0")
+		.replace(/mon/gi, "1")
+		.replace(/tue/gi, "2")
+		.replace(/wed/gi, "3")
+		.replace(/thu/gi, "4")
+		.replace(/fri/gi, "5")
+		.replace(/sat/gi, "6");
+};
+
+/**
+ * Replace month name with month numbers
+ * @private
+ * 
+ * @param {string} conf - Current part, expected to be a string that might contain jan,feb etc.
+ * 
+ * @returns {string} - conf with 0 instead of sun etc.
+ */
+CronPattern.prototype.replaceAlphaMonths = function (conf) {
+	return conf
+		.replace(/jan/gi, "1")
+		.replace(/feb/gi, "2")
+		.replace(/mar/gi, "3")
+		.replace(/apr/gi, "4")
+		.replace(/may/gi, "5")
+		.replace(/jun/gi, "6")
+		.replace(/jul/gi, "7")
+		.replace(/aug/gi, "8")
+		.replace(/sep/gi, "9")
+		.replace(/oct/gi, "10")
+		.replace(/nov/gi, "11")
+		.replace(/dec/gi, "12");
 };
 
 export { CronPattern };

package/test/src/suite.cjs

@@ -343,21 +343,18 @@ module.exports = function (Cron) {
 				nextRun;
 
 			// Set a fixed hour later than startAt, to be sure that the days doesn't overlap
-			nextDay =  new Date(nextDay.setHours(13));
-			dayAfterNext = new Date(dayAfterNext.setHours(13));
-
-			scheduler = new Cron("0 0 12 * * *", { startAt: nextDay });
+			nextDay =  new Date(nextDay.setUTCHours(13));
+			scheduler = new Cron("0 0 12 * * *", {timezone: "Etc/UTC", startAt: nextDay.toISOString() });
 			nextRun = scheduler.next();
 
 			// Set seconds, minutes and hours to 00:00:00
 			dayAfterNext.setMilliseconds(0);
-			dayAfterNext.setSeconds(0);
-			dayAfterNext.setMinutes(0);
-			dayAfterNext.setHours(12);
+			dayAfterNext.setUTCSeconds(0);
+			dayAfterNext.setUTCMinutes(0);
+			dayAfterNext.setUTCHours(12);	
 
 			// Do comparison
 			nextRun.getTime().should.equal(dayAfterNext.getTime());
-            
 
 		});
 
@@ -390,7 +387,7 @@ module.exports = function (Cron) {
 		it("0 0 12 * * * with stopdate yesterday should return undefined", function () {
 			let 
 				dayBefore = new Date(new Date().getTime()-24*60*60*1000), // Subtract one day
-				scheduler = new Cron("0 0 12 * * *", { stopAt: dayBefore }),
+				scheduler = new Cron("0 0 12 * * *", { timezone: "Etc/UTC", stopAt: dayBefore.toISOString() }),
 				nextRun = scheduler.next();
 
 			// Do comparison
@@ -456,15 +453,6 @@ module.exports = function (Cron) {
 
 		});
 
-		it("Valid startAt with Date should not throw", function () {
-			(function ()  {
-				let 
-					dayBefore = new Date(new Date().getTime()-24*60*60*1000), // Subtract one day
-					scheduler = new Cron("0 0 12 * * *", { startAt: dayBefore });
-				scheduler.next();
-			}).should.not.throw();
-		});
-
 		it("Valid startAt with DateTime string should not throw", function () {
 			(function ()  {
 				let 
@@ -473,12 +461,12 @@ module.exports = function (Cron) {
 			}).should.not.throw();
 		});
 
-		it("Valid startAt with Date string should not throw", function () {
+		it("startAt with Date string should throw", function () {
 			(function ()  {
 				let 
 					scheduler = new Cron("0 0 12 * * *", { startAt: "2016-12-01" });
 				scheduler.next();
-			}).should.not.throw();
+			}).should.throw();
 		});
 
 		it("Invalid startat should throw", function () {
@@ -514,12 +502,12 @@ module.exports = function (Cron) {
 			}).should.not.throw();
 		});
 
-		it("Valid stopAt with Date string should not throw", function () {
+		it("Valid stopAt with Date string should throw", function () {
 			(function ()  {
 				let 
 					scheduler = new Cron("0 0 12 * * *", { stopAt: "2016-12-01" });
 				scheduler.next();
-			}).should.not.throw();
+			}).should.throw();
 		});
 
 		it("Invalid stopAt should throw", function () {
@@ -567,14 +555,15 @@ module.exports = function (Cron) {
 				diff;
 
 			target.getTime().should.equal(scheduler.next().getTime());
-
 			if(target.getTime() === scheduler.next().getTime()) {
 				while(prevRun < target) {
 					left = scheduler.msToNext(prevRun);
 					diff = Math.abs((target.getTime() - prevRun.getTime())-left);
 					diff.should.be.below(1001);
 					diff.should.be.above(-1);
-					prevRun = new Date(prevRun.getTime() + 1000000);
+
+					// Advance 1000s
+					prevRun.setMilliseconds(1000000);
 				}
 			}
 
@@ -595,13 +584,14 @@ module.exports = function (Cron) {
 					diff = Math.abs((target.getTime() - prevRun.getTime())-left);
 					diff.should.be.below(1001);
 					diff.should.be.above(-1);
-					prevRun = new Date(prevRun.getTime() + 1000000);
+
+					// Advance 1000s
+					prevRun.setMilliseconds(1000000);
 				}
 			}
 
 		});
 		it("Test when next thursday 1st november occurr, starting from 2021-10-13 00:00:00", function () {
-			//Cron("0 0 0 1 11 4").next(new Date(1634076000000)).getTime().should.equal(1888182000000);
 			Cron("0 0 0 1 11 4").next(new Date(1634076000000)).getFullYear().should.equal(2029);
 		});
 		it("getTime should return expcted difference with different timezones (now)", function () {
@@ -609,24 +599,25 @@ module.exports = function (Cron) {
 				timeNewYork = Cron("* * * * * *", {timezone: "America/New_York"}).next(new Date()).getTime();
 
 			// The time right now should be the same in utc wether in new york or stockholm
-			timeStockholm.should.be.above(timeNewYork-1000);
-			timeStockholm.should.be.below(timeNewYork+1000);
+			timeStockholm.should.be.above(timeNewYork-4000);
+			timeStockholm.should.be.below(timeNewYork+4000);
 		});
-		/*it("getTime should return expcted difference with different timezones (net sunday 1st november)", function () {
+		it("getTime should return expcted difference with different timezones (net sunday 1st november)", function () {
 			let timeStockholm = Cron("* * * 1 11 4", {timezone: "Europe/Stockholm"}).next(new Date(1634076000000)).getTime(),
-				timeNewYork = Cron("* * * 1 11 4", {timezone: "America/New_York"}).next(new Date(1634076000000)).getTime();
+				timeNewYork = Cron("* * * 1 11 4", {timezone: "America/New_York"}).next(new Date(1634076000000)).getTime(),
+				diff = (timeNewYork-timeStockholm)/1000/3600;
 
 			// The time when next sunday 1st november occur should be with 6 hours difference (seen from utc)
-			timeStockholm.should.equal(timeNewYork-6*1000*3600);
-		});*/
+			diff.should.equal(6);
+		});
 		it("maxRuns should be inherited from scheduler to job", function () {
 			let scheduler = Cron("* * * 1 11 4", {maxRuns: 14}),
 				job = scheduler.schedule(() => {});
 			job.options.maxRuns.should.equal(14);
 			job.stop();
 		});
-		it("Next saturday at 29th of february should occur 2048", function () {
-			let nextSaturday29feb = Cron("0 0 0 29 2 6").next(new Date(1634076000000));
+		it("Next saturday at 29th of february should occur 2048. Also test weekday an month names and case insensitivity", function () {
+			let nextSaturday29feb = Cron("0 0 0 29 feb SAT").next(new Date(1634076000000));
 			nextSaturday29feb.getFullYear().should.equal(2048);
 		});
 		it("Impossible combination should result in null", function () {

package/types/croner.d.ts

@@ -103,25 +103,27 @@ export class Cron {
     next(prev?: Date): Date | null;
     /**
      * Return previous run time
+     * @public
      *
-     * @returns {Date | null} - Previous run time
+     * @returns {CronDate | null} - Previous run time
      */
-    previous(): Date | null;
+    public previous(): CronDate | null;
     private _next;
     /**
      * Returns number of milliseconds to next run
+     * @public
      *
      * @param {CronNextResult} [prev=new CronDate()] - Starting date, defaults to now
      * @returns {number | null}
      */
-    msToNext(prev?: CronNextResult): number | null;
+    public msToNext(prev?: CronNextResult): number | null;
     /**
      * Stop execution
      * @public
      */
     public stop(): void;
     /**
-     * Pause execution
+     * Pause executionR
      * @public
      *
      * @returns {boolean} - Wether pause was successful

package/types/date.d.ts

@@ -2,7 +2,7 @@
  * Converts date to CronDate
  * @constructor
  *
- * @param {date|string} [date] - Input date
+ * @param {date|string} [date] - Input date, if using string representation ISO 8001 (2015-11-24T19:40:00) local timezone is expected
  * @param {string} [timezone] - String representation of timezone in Europe/Stockholm format.
  */
 export function CronDate(date?: any, timezone?: string): void;
@@ -11,7 +11,7 @@ export class CronDate {
      * Converts date to CronDate
      * @constructor
      *
-     * @param {date|string} [date] - Input date
+     * @param {date|string} [date] - Input date, if using string representation ISO 8001 (2015-11-24T19:40:00) local timezone is expected
      * @param {string} [timezone] - String representation of timezone in Europe/Stockholm format.
      */
     constructor(date?: any, timezone?: string);
@@ -40,16 +40,18 @@ export class CronDate {
      * Convert current state back to a javascript Date()
      * @public
      *
+     * @param {boolean} internal - If this is an internal call
      * @returns {date}
      *
      */
-    public getDate(): any;
+    public getDate(internal: boolean): any;
     /**
      * Convert current state back to a javascript Date() and return UTC milliseconds
      * @public
-     *
+     * @param {boolean} internal - If this is an internal call
      * @returns {date}
      *
      */
-    public getTime(): any;
+    public getTime(internal: boolean): any;
+    private parseISOLocal;
 }

package/types/pattern.d.ts

@@ -28,16 +28,12 @@ export class CronPattern {
     days: any[];
     months: any[];
     daysOfWeek: any[];
-    /**
-     * Parse current pattern, will raise an error on failure
-     */
-    parse(): void;
-    /**
-     * Convert current part (seconds/minutes etc) to an array of 1 or 0 depending on if the part is about to trigger a run or not.
-     *
-     * @param {CronPatternPart} type - Seconds/minutes etc
-     * @param {string} conf - Current pattern part - *, 0-1 etc
-     * @param {CronIndexOffset} valueIndexOffset - 0 or -1. 0 for seconds,minutes, hours as they start on 1. -1 on days and months, as the start on 0
-     */
-    partToArray(type: CronPatternPart, conf: string, valueIndexOffset: CronIndexOffset): void;
+    private parse;
+    private partToArray;
+    private throwAtIllegalCharacters;
+    private handleNumber;
+    private handleRange;
+    private handleStepping;
+    private replaceAlphaDays;
+    private replaceAlphaMonths;
 }