chrono

date/time related helpers

Starting with v2.0.0, this is an ECMAScript module—stick with v1.x.x if you need a CommonJS module.

Exports

timestamp ( number )

Takes a number of milliseconds since January 1, 1970, 00:00:00 UTC (defaults to current time) and returns a string of the form 'YYYY-MM-DD HH:MM:SS'. The space between the date and time is a non-breaking space (U+00A0).

datetag ( number )

Takes a number of milliseconds since January 1, 1970, 00:00:00 UTC (defaults to current time) and returns a string of the form 'YYYY-MM-DD'.

dateFromUnix ( number )

Returns a Javascript Date object for the given unix timestamp (in seconds from 1970). Returns null if a number is not passed.

unixTime ( number or Date )

Returns a unix timestamp (in seconds from 1970) for a given Javascript Date object or equivalent number of milliseconds from 1970.

localDate ( string )

returns a Date object corresponding to a local date string in 'Y-M-D' format. 'Y-M' is interpereted as 'Y-M-1'.

Cron ( interval: number, days: iterable, hours: iterable )

class for creating an object that emits a cron event every interval milliseconds if current weekday index ∈ days and current hour index ∈ hours. Defaults for days and hours include all days and times. Event handlers for cron events are passed a Date object representing the instant the event was emitted.

Cron.prototype.interval: get or set the event interval (milliseconds)

Cron.prototype.days: get or set the Set of weekday indices on which events are emitted

Cron.prototype.hours: get or set the Set of hour indices during which events are emitted

Cron.prototype.close(): stop emitting events

months

An array of month information objects with fields:

| field | description | | --- | --- | | index | 0-based month number: January = 0 … December = 11 | | id | 1-based month number: January = 1 … December = 12 | | digits | 2-digit string: January = '01' … December = '12' | | long | full month name: 'January' … 'December' | | short | 3-character month abbreviation: 'Jan' … 'Dec' | | days | number of days in month (ignoring leap-years) |

weekdays

An array of weekday information objects with fields:

| field | description | | --- | --- | | index | 0-based weekday number: Sunday = 0 … Saturday = 6 | | long | full weekday name: 'Sunday' … 'Saturday' | | short | 3-character weekday abbreviation: 'Sun' … 'Sat' | | narrow | single character abbreviation (not injective) |

hours

An array of hour information objects with fields:

| field | description | | --- | --- | | index | 0-based hour number: 0 … 23 | | digits | 2-digit string: '00' … '23' |