normalize-date
v0.0.4
Published
converts date from any format to native UTC JS Date
Downloads
1,494
Maintainers
Readme
normalize-date
Converts date from any format to native UTC JS Date. It is useful for further comparison
Note: This module works in browsers and Node.js >= 4.0
Installation
npm install normalize-date
Usage
const toDate = require('normalize-date');
const date1 = toDate('2000-01-05T23:59:59.000Z');
const date2 = toDate('947116799.000');
date1.valueOf() === date2.valueOf() //true
const date3 = toDate('2000-01-05T23:59:59', {noTime: true});
const date4 = toDate(new Date(2000, 0, 5), {noTime: true});
date3.valueOf() === date4.valueOf() //true
//Some of possible formats
toDate('2000-01-05') //ISO 8601
toDate('2000-01-05T23:59:59Z') //ISO 8601
toDate('2000-01-05T23:59:59.000+00:00') //ISO 8601
toDate('Sat Jan 05 2000 23:59:59') //RFC 2822
toDate('Sat Jan 05 2000 22:59:59 GMT-0415') //RFC 2822
toDate(947116799000) //the number of milliseconds since 1970
toDate('947116799.000') //UNIX timestamp
toDate(new Date(2000, 0, 5, 23, 59, 59, 0)) //JS Date
toDate([2000, 0, 5, 23, 59, 59, 0]) //arguments for Date constructor
toDate(moment('2000-01-05T23:59:59.000')) //MomentJS date
API
normalizeDate(date, [options])
date (
Any
) - Date as JS Date (or array with arguments), Moment, time, timestamp, ISO 8601, RFC 2822options (
Object
) - Options- noTime (
Boolean
) - clear time
- noTime (
return (
Date
) - Native JavaScript Date (in UTC)
Tests
npm install
npm test