calcudate
v2.0.0
Published
Light weight general date calculation for JavaScript
Downloads
4
Maintainers
Readme
#Calcudate 2.0
##Usage
npm install calcudate
Sum Years, months, days, hours, minutes or seconds to a date:
let date = require('calcudate');
let someDate = new Date('2015-11-12');
//add ten years
date.add(new Date()).years(10)
//returns date '2015-11-12T00:00:00'
date.add(someDate).months(10)
//return date '2016-10-20T10:10:10.000'
date.add(new Date('2016-10-10T10:10:10.000')).days(10)
//add ten hours
date.add(new Date()).hours(10)
//add ten minutess
date.add(new Date()).minutes(10)
//add ten seconds
date.add(new Date()).secs(10)
Subtract Years, months, days, hours, minutes or seconds of a date:
let date = require('calcudate');
let someDate = new Date('2015-11-12');
//subtract ten years
date.sub(new Date()).years(10)
// returns date '2015-01-12T00:00:00'
date.sub(someDate).months(10)
//return date '2016-10-10T10:10:10.000'
date.sub(new Date('2016-10-10T10:10:10.000')).days(10)
//subtract ten hours
date.sub(new Date()).hours(10)
//subtract ten minutess
date.sub(new Date()).minutes(10)
//subtract ten seconds
date.sub(new Date()).secs(10)
Get start time of day or hour (On local time!)
let date = require('calcudate');
let aDate = new Date('2017-02-20T22:02:36:23.296');
let myDate = getStart(aDate).day;
/*
WARNING - return 2017-02-20T00:00:00:00.000 or
2017-02-20T03:00:00:00.000 depeding local time
*/
Get the last day or date of a month:
let date = require('calcudate');
let lastFebLast = date.getLastOf(new Date('2015-02-01 03:00:00')).day;
//return 28
let lastMar = date.getLastOf(new Date('2016-03-01 03:00:00')).day;
//return 29
let lastApr = date.getLastOf(new Date('2016-04-01 03:00:00')).day;
//return 31
Get the integer timezone offset or the string
let date = require('calcudate');
//return local offset integer like 0 for GMT or 180 for BRT
let offset = date.getOffset().int;
//return local offset integer like +0000 for GMT or -0300 for BRT
let offset = date.getOffset().str;
##Main differences from 1.x.x versions: Added support for browser (calcudate/dist/js/calcudate.js)
<script type="text/javascript" src="../dist/js/calcudate.js"></script>
-Fixed several error on add and sub for years ans months that disconsidered minutes and seconds. -Fixed getOffset() for regions with GMT whithout straight hours offset.(-01:30, +04:45, ...)
- Added aliases to all add and sub methods, becouse the didi not have veri intuitive names
- Add secconds
Alias that works just like it's relative method, both in add and sub. Here ar all of then: - secs -> s, seconds; - minutes -> m, i, mins; - hours -> h; - days -> d; - months -> M, mo; - years -> y, Y; Other alias that works: - getLastOf.day -> getLastOf.d - getStart.day -> getStart.d - getStart.hour -> getStart.h - getOffset.str -> getOffset.string -> getOffset.s - getOffset.int -> getOffset.integer -> getOffset.ilet myDate = new Date(); let date = require('calcudate'); let test = date.add(myDate).s(10); let test1 = date.add(myDate).secs(10); let test2 = date.add(myDate).seconds(10); return +test === +test1 && test === test2; //returns true