calcudate

2.0.0 • Public • Published

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
    let 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
    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.i

Package Sidebar

Install

npm i calcudate

Weekly Downloads

1

Version

2.0.0

License

MIT

Last publish

Collaborators

  • desoares