ranged-date

ranged-date

Converts a given input to the number of milliseconds since the Unix epoch, provided that it can be parsed and recognized as seconds, milliseconds, or microseconds within a specified range in years.

Getting Started

Prerequisites

Node.JS version 6.0.0 or above.

Installing

npm i ranged-date

Testing

The following command will test the package for errors.

npm test

Deployment

const rangedDate = require('ranged-date')

Usage

const time   = ~~(Date.now() / 1000) // Test unixtime in seconds
const past   = time - 31536000       // One year prior
const future = time + 31536000       // One year after

console.log(rangedDate(time))               // converted ms
console.log(rangedDate(time * 1000))        // converted ms
console.log(rangedDate(time * 1000 * 1000)) // converted ms
console.log(rangedDate(String(time)))       // converted ms
console.log(rangedDate(past))               // false
console.log(rangedDate(past, 2))            // converted ms
console.log(rangedDate(future))             // false
console.log(rangedDate(future, null, 2))    // converted ms

Documentation

rangedDate ⇒ number | boolean

Returns: number | boolean - Converted ms or false if outside range.

Param	Type	Attributes	Default	Description
data	Date | number | string			Data to attempt to match.
low	number	<optional>	0.5	Lower bound, in years.
up	number	<optional>	0.5	Upper bound, in years.

Please refer to the docs for more in-depth documentation.

Versioning

Versioning using SemVer. For available versions, see the tags on this repository.

Author

• Justin Collier - jpcx

License

This project is licensed under the ISC License - see the LICENSE.md file for details