Tiny library to create and manipulate Unix timestamps in Javascript. (A Unix timestamp is the number of seconds elapsed since Unix epoch time, i.e. January 1 1970 00:00 UTC.)
npm install unix-timestamp
Then:
const timestamp = require('unix-timestamp');
.now([offset])
gives the current time, optionally applying an offset (see below).fromDate(dateOrString)
gives the time from a Javascript Date object or an ISO 8601 date string.toDate(time)
correspondingly gives the date from a timestamp.add(time, offset)
applies an offset to the given time.duration(offset)
gives the offset timestamp for the given offset string
An offset can be either a number (unit: seconds) or a string with format [+|-] [{years}y] [{months}M] [{weeks}w] [{days}d] [{hours}h] [{minutes}m] [{seconds}s] [{milliseconds}ms]
(for example -30s
).
The actual values (in seconds) used for each unit of time in an offset string are exposed by properties .Millisecond
, .Second
, .Minute
, .Hour
, .Day
, .Week
, .Month
(i.e. mean Gregorian month) and .Year
.
By default timestamps include decimals (fractions of a second). You can set the lib to round all returned timestamps to the second with timestamp.round = true
.
npm test
runs the tests with Mocha.
npm run test-cover
runs the tests and outputs coverage stats with Istanbul.
npm run license
updates license information with source-licenser.
The code follows the Semi-Standard style.