date.js

Go to the documentation of this file.

 
define( [
                'remoto!stdlib:js/include/utils.js',
        ],
        function(utils)
        {
                'use strict';
 
                function date(year, month, day, hours, minutes, seconds, milliseconds)
                {
                        var _date;
 
                        if (arguments.length > 1)
                                _date = new Date(year, month, day, hours, minutes, seconds, milliseconds);
                        else if (arguments.length == 1)
                        {       if (arguments[0] instanceof Date)
                                        _date = new Date(arguments[0]);
                                else
                                {       _date = new Date();
                                        _date.setTime(arguments[0]);
                                        //console.log(_date);
                                }
                        }
                        else
                                _date = new Date();
 
                        _date.setMilliseconds(0);                               //our dates only have a resolution of 1 second.
                        _date.setSeconds(0);                                    //in fact, of only one minute.
 
                        this._date = _date;
 
                        //console.log(_date);
 
                        /*
                        var THIS = this;
                        var v = function()
                        {
                                return THIS.toString();
                        }
 
                        this.value = v.bind(this);
                        */
                }
 
                date.wkdays = [ "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" ];
                date.weekdays = [ "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" ];
                date.months = [ "Jan", "Feb", "Mar", "Apr", "May", "June", "July", "Aug", "Sept", "Oct", "Nov", "Dec" ];
                date.monthsFull = [ "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" ];
 
                date.msMinute = 1000*60;                //milliseconds in a minute
                date.msHour = 1000*60*60;               //milliseconds in an hour
                date.msDay = 1000*60*60*24;             //milliseconds in a day
                date.ms15 = 1000*60*15;                 //milliseconds in 15 minutes
                date.msWeek = 1000*60*60*24*7;          //milliseconds in a week
 
                //FIXME: offset should be used in certain calculations, but which!
                date.offset = 0;                        //number of milliseconds of offset between the server and the local machine.
 
                date.spad =     function(s,l)
                                {
                                        l = l || 6;
                                        s = "000000"+s;
                                        s = s.substr(s.length-l,l);
                                        return s;
                                };
 
                date.prototype = {
 
                        /*
                        value:          function()
                                        {
                                                return this.toString();
                                        },
                        */
 
                        firstDayOfWeek: function()
                                        {
                                                var d = new Date( this._date );
                                                var day = d.getDay();
                                                var diff = d.getDate() - day + (day == 0 ? -6:1); // adjust when day is sunday
                                                d.setDate(diff);
                                                d.setHours(0);
                                                d.setMinutes(0);
                                                d.setSeconds(0);
                                                d.setMilliseconds(0);
                                                return new date(d);
                                        },
 
                        lastDayOfWeek:  function()
                                        {
                                                var d = new Date( this._date );
                                                var day = d.getDay();
                                                var diff = d.getDate() - day + (day == 0 ? 0:7);
                                                d.setDate(diff);
                                                d.setHours(0);
                                                d.setMinutes(0);
                                                d.setSeconds(0);
                                                d.setMilliseconds(0);
                                                return new date(d);
                                        },
 
                        fieldString:    function(sep)                                           //for safari/browser compatibility, as toLocaleString is not reliable enough to reverse-parse.
                                        {
                                                sep = sep || "/";
 
                                                var d = this._date;
                                                var _st = ""
                                                _st += date.spad(d.getMonth()+1,2);
                                                _st += sep + date.spad(d.getDate(),2);
                                                _st += sep + d.getFullYear();
                                                return _st;
                                        },
 
                        timeString:     function(use12)
                                        {
                                                var d = this._date;
                                                var vv = "";
 
                                                if (use12)
                                                {       
                                                        vv +=       date.spad(d.getHours()%12,2);
                                                        vv += ":" + date.spad(d.getMinutes(),2);
                                                        vv += d.getHours() > 11 ? " pm" : " am";
                                                }
                                                else
                                                {
                                                        vv +=       date.spad(d.getHours(),2);
                                                        vv += ":" + date.spad(d.getMinutes(),2);
                                                }
 
                                                return vv;
                                        },
 
                        lengthString:   function()
                                        {
                                                var t = this.time;
                                                var m = Math.round( t / (1000*60) );
                                                var h = Math.floor( m / 60 );
                                                return (h>0 ? h+" hr"+(h>1?"s":"")+", " : "")+(m%60)+" min"+((m%60)>1?"s":"");
                                        },
 
                        lengthString2:  function()
                                        {
                                                var t = this.time;
                                                var m = Math.round( t / (1000*60) );
                                                var h = Math.floor( m / 60 );
                                                return (h>0 ? h : "")+":"+date.spad((m%60),2);
                                        },
 
                        daysHoursMinutesString: function()                                      //from zero, expected to be used in the context of: var h_m = (new date(e.time - s.time)).hoursMinutesString();
                                        {
                                                var t = this.time;
                                                var m = Math.floor( t / (1000*60) );
                                                var h = Math.floor( m / 60 );
                                                var d = Math.floor( h / 24 );
                                                var _s = "";
                                                _s += d > 0 ? d +":" : "";
                                                _s += date.spad( h % 24, 2 );
                                                _s += ":" + date.spad( m % 60, 2 );
 
                                                return _s;
                                        },
 
                        fullString:     function(withSeconds)
                                        {
                                                var d = this._date;
                                                var vv = "";
 
                                                vv += date.spad(d.getMonth()+1,2);
                                                vv += "/" + date.spad(d.getDate(),2);
                                                vv += "/" + d.getFullYear();
                                                vv += " " + date.spad(d.getHours(),2);
                                                vv += ":" + date.spad(d.getMinutes(),2);
 
                                                if (withSeconds)
                                                        vv += ":" + date.spad(d.getSeconds(),2);
                                                //vv += " " + d.getTimezone();
 
                                                var zone = d.toLocaleTimeString('en-us',{timeZoneName:'short'}).split(' ')[2];
                                                //console.log(zone)
                                                vv += " "+zone;
 
                                                return vv;
                                        },
 
                        prettyString:   function()
                                        {
                                                //var d = this._date.getDay();
                                                var m = this._date.getMonth();
                                                //d = date.weekdays[ d ];
                                                m = date.months[ m ];
 
                                                return m+" "+this._date.getDate()+", "+this._date.getFullYear();
                                        },
 
                        dayMonthString: function()
                                        {
                                                return (this._date.getMonth()+1)+"/"+date.spad(this._date.getDate(),2);
                                        },
 
                        //      getters/setters
 
                        get id()        {
                                                return this._date.valueOf();
                                        },
 
                        /*
                        set id(_id)     {
                                                console.dir(this);
                                                return this.time = _id;
                                        },
                        */
 
                        get year()      {       return this._date.getFullYear();
                                        },
 
                        get date()      {       return this._date.getDate();
                                        },
 
                        set date(d)     {       return this._date.setDate(d);
                                        },
 
                        get monthString() {     return date.months[ this._date.getMonth() ];
                                        },
 
                        get monthStringFull() { return date.monthsFull[ this._date.getMonth() ];
                                        },
 
                        get month()     {       return this._date.getMonth();
                                        },
 
                        set month(m)    {       return this._date.setMonth(m);
                                        },
 
                        get daysInMonth() {     var d = new Date(this._date);
                                                d.setMonth( this._date.getMonth()+1 );
                                                d.setDate(-1);
                                                return d.getDate()+1;
                                        },
 
                        get day()       {       return this._date.getDay();
                                        },
 
                        get weekday()   {       return date.wkdays[ this._date.getDay() ];
                                        },
 
                        get yearday()   {       //return date.
                                        },
 
                        set minutes(m)  {       this._date.setHours(Math.floor(m/60));
                                                this._date.setMinutes(m%60,0,0);
                                        },
 
                        set seconds(s)  {       this._date.setSeconds(s);
                                        },
 
                        get minutes()   {       return this._date.getHours()*60+this._date.getMinutes();
                                        },
 
                        get time()      {       return this._date.getTime();
                                        },
 
                        set time(t)     {       return this._date.setTime(t);
                                        },
 
                        headerString:   function()
                                        {
                                                var d = this._date.getDay();
                                                var m = this._date.getMonth();
                                                d = date.weekdays[ d ];
                                                m = date.months[ m ];
 
                                                return d+", "+m+" "+this._date.getDate();
                                        },
 
                        daysTo:         function(end)
                                        {
                                                var t = this._date.valueOf();
                                                var e = end._date.valueOf();
                                                var d = e-t;
                                                var days = Math.round(d/(1000*60*60*24));
                                                return days;
                                        },
 
                        minutesTo:      function(end)
                                        {
                                                var t = this._date.valueOf();
                                                var e = end._date.valueOf();
                                                var d = e-t;
                                                var minutes = d/(1000*60);
                                                return minutes;
                                        },
 
                        /*
                        timeToNextMinute: function()
                                        {
                                                var d = new date( this._date );
                                                d.seconds = 0;
                                                d.minutes = d.minutes+1;
 
                                                return d.time - this.time;
                                        },
                        */
 
                        isWeekend:      function()
                                        {
                                                var d = this._date.getDay();
 
                                                return (d==0 || d==6);
                                        },
 
                        nextDay:        function()
                                        {
                                                var d = new Date( this._date );
                                                var diff = d.getDate() + 1;
                                                d.setDate(diff);
                                                d.setHours(0);
                                                d.setMinutes(0);
                                                d.setSeconds(0);
                                                d.setMilliseconds(0);
                                                return new date(d);
                                        },
 
                        prevDay:        function()
                                        {
                                                var d = new Date( this._date );
                                                var diff = d.getDate() - 1;
                                                d.setDate(diff);
                                                d.setHours(0);
                                                d.setMinutes(0);
                                                d.setSeconds(0);
                                                d.setMilliseconds(0);
                                                return new date(d);
                                        },
 
                        thisDay:        function()
                                        {
                                                var d = new Date( this._date );
                                                d.setHours(0);
                                                d.setMinutes(0);
                                                d.setSeconds(0);
                                                d.setMilliseconds(0);
                                                return new date(d);
                                        },
 
                        offsetByDays:   function(off)
                                        {
                                                /*
                                                var d = this._date.getTime();
                                                d += (off * 24 * 60 * 60 * 1000);               //offset by a number of days
                                                this._date.setTime(d);
                                                */
 
                                                var d = this._date.getDate();
                                                var h = this._date.getHours();
                                                d += off;
 
                                                var t = new Date(this._date);
                                                t.setDate(d);
                                                t.setHours(h);
 
                                                return new date(t);
                                        },
 
                        startUTC:       function()
                                        {
                                                return this.thisDay()._date.getTime();
                                        },
 
                        endUTC:         function()
                                        {
                                                return this.nextDay().startUTC() - 1;
                                        },
 
                        intersects:     function(s,e,l)                         //if this _date including l minutes is anywhere inside s,e
                                        {
                                                var S = s._date.getTime() || Date.now();        //the start time that we're intersecting, but zero is considered now()
                                                var E = e._date.getTime() || Date.now();        //the end time that we're intersecting, but zero is considered now()
                                                var TS = this._date.getTime();                  //the time of this, at the start
                                                var TE = TS+l;                                  //the time of this, at the end of the range
 
                                                if (E < S)                                      //this can happen, but we leave the S=E case as ok.
                                                        return false;
 
                                                //three cases:
                                                //start is within range
                                                //end is witin range
                                                //start and end are before and after range
 
                                                if (TS <= S && TE > S)
                                                        return true;
 
                                                if (TS < E && TE > E)
                                                        return true;
 
                                                if (TS >= S && TE <= E)
                                                        return true;
 
                                                return false;
                                        },
 
                        amountWithin:   function(s,n,l)
                                        {
                                                s = utils.bound( this.time, s, this.time + l );
                                                n = utils.bound( this.time, n, this.time + l );
                                                //console.log(s+" "+n+" "+(n-s));
 
                                                return n-s;                                                     //in milliseconds
                                        },
 
                        toString:       function()
                                        {
                                                return this._date.getTime();
                                                //return this._date.toString();
                                        },
                };
                
                date.timeToNextMinute = function()
                {
                        var n = new Date();
                        var d = new Date();
                        d.setSeconds(0);
                        d.setMinutes(d.getMinutes()+1);
                        return d.getTime() - n.getTime();
                }
 
                return date;
        }
);