Loaf Date

Easily output the date format or difference.

Install

npm install --save loaf-date

How to use

import LD from 'loaf-date';

const dateForamt = LD().format('Y-M-D H:MN:S');
console.log(dateForamt);
// 2019-01-03 02:52:17

import LD from 'loaf-date';

const baseDate = LD('2019-01-01 00:00:00');
const targetDate = LD('2019-02-01 00:00:00');

console.log(baseDate.diff(targetDate, 'months'));
// 1

import LD from 'loaf-date';

const addDays = LD('2019-01-01').add(5, 'days').format('Y-M-D');
console.log(addDays);
// 2019-01-06

Format

import LD from 'loaf-date';

// year
LD('2019-01-03 04:05:06').format('y'); // 19
LD('2019-01-03 04:05:06').format('Y'); // 2019

// month
LD('2019-01-03 04:05:06').format('m') // 1
LD('2019-01-03 04:05:06').format('M') // 01

// date
LD('2019-01-03 04:05:06').format('m') // 3
LD('2019-01-03 04:05:06').format('M') // 03

// hour
LD('2019-01-03 04:05:06').format('m') // 4
LD('2019-01-03 04:05:06').format('M') // 04

// minute
LD('2019-01-03 04:05:06').format('mn') // 5
LD('2019-01-03 04:05:06').format('MN') // 05

// second
LD('2019-01-03 04:05:06').format('s') // 6
LD('2019-01-03 04:05:06').format('S') // 06

// time
LD('2019-01-03 04:05:06').format('t') //ex. 1546286705000

// day of the week
LD('2019-01-03 04:05:06').format('w') //ex. 4
// Sunday = 0;
// Monday = 1;
// ...
// Saturday = 6;
LD('2019-01-03 04:05:06').format('W') //ex. 5
// Monday = 0;
// ...
// Sunday = 6;

// milliseconds
LD('2019-01-03 04:05:06').format('ms') // ex. 0
LD('2019-01-03 04:05:06').format('MS') // ex. 000

Difference

import LD from 'loaf-date';

// yesrs
LD('2019-01-01 05:05:05').diff(LD('2018-01-01 05:05:05'), 'years') // -1
// months
LD('2018-03-01 05:05:05').diff(LD('2017-03-01 05:05:05'), 'months'); // -12
// weeks
LD('2019-01-01 05:05:05').diff(LD('2019-01-08 05:05:05'), 'weeks'); // 1
// days
LD('2019-01-01 05:05:05').diff(LD('2018-01-01 05:05:05'), 'days'); // -365
// hours
LD('2018-01-01 05:05:05').diff(LD('2018-01-01 10:05:05'), 'hours'); // 5
// minutes
LD('2018-01-01 05:05:05').diff(LD('2018-01-01 05:10:06'), 'minutes'); // 5
// seconds
LD('2018-01-01 05:05:05').diff(LD('2018-01-01 05:05:10'), 'seconds'); // 5

Add a date

// years
LD('2019-01-01').add(-1, 'years').format('Y-M-D'); // 2018-01-01
// months
LD('2019-01-01').add(-1, 'months').format('Y-M-D'); // 2018-12-01
// weeks
LD('2019-01-01').add(2, 'weeks').format('Y-M-D'); // 2019-01-15
// days
LD('2019-01-01').add(5, 'days').format('Y-M-D'); // 2019-01-06
// hours
LD('2019-01-01 10:00:00').add(1, 'hours').format('Y-M-D H:MN:S'); // 2019-01-01 11:00:00
// minutes
LD('2019-01-01 10:00:00').add(30, 'minutes').format('Y-M-D H:MN:S'); // 2019-01-01 10:30:00
// seconds
LD('2019-01-01 10:00:00').add(30, 'seconds').format('Y-M-D H:MN:S'); // 2019-01-01 10:00:30

// add multiple different keys
LD('2019-01-01 04:05:06').add(-1, 'years').add(5, 'days').format('Y-M-D')); // 2018-01-06

License

MIT