Date

Date.prototype.format =Date.prototype.dateFormat Date.createNewFormat = function(     format )

Formats a date given the supplied format string format - {String}The format string

Returns

{String} The formatted date @method

Date.parseDate = function( input, format )

Parses the passed string using the specified format.  Note that this function expects dates in normal calendar format, meaning that months are 1-based (1 = January) and not zero-based like in JavaScript dates.  Any part of the date format that is not specified will default to the current date value for that part.  Time parts can also be specified, but default to 0.  Keep in mind that the input date string must precisely match the specified format string or the parse operation will fail.  Example Usage:

//dt = Fri May 25 2007 (current date)
var dt = new Date();

//dt = Thu May 25 2006 (today's month/day in 2006)
dt = Date.parseDate("2006", "Y");

//dt = Sun Jan 15 2006 (all date parts specified)
dt = Date.parseDate("2006-1-15", "Y-m-d");

//dt = Sun Jan 15 2006 15:20:01 GMT-0600 (CST)
dt = Date.parseDate("2006-1-15 3:20:01 PM", "Y-m-d h:i:s A" );

Returns

{Date} The parsed date @static

Date.prototype.getTimezone = function()

Get the timezone abbreviation of the current date (equivalent to the format specifier ‘T’).

Returns

{String} The abbreviated timezone name (e.g.  ‘CST’)

Date.prototype.getGMTOffset = function()

Get the offset from GMT of the current date (equivalent to the format specifier ‘O’).

Returns

Date.prototype.getDayOfYear = function()

Get the numeric day number of the year, adjusted for leap year.

Returns

{Number} 0 through 364 (365 in leap years)

Date.prototype.getWeekOfYear = function()

Get the string representation of the numeric week number of the year (equivalent to the format specifier ‘W’).

Returns

{String} ‘00’ through ‘52’

Date.prototype.getFirstDayOfMonth = function()

Get the first day of the current month, adjusted for leap year.  The returned value is the numeric day index within the week (0-6) which can be used in conjunction with the {@link #monthNames} array to retrieve the textual day name.  Example:

var dt = new Date('1/10/2007');
Myna.println(Date.dayNames[dt.getFirstDayOfMonth()]); //output: 'Monday'

Returns

{Number} The day number (0-6)

Date.prototype.getLastDayOfMonth = function()

Get the last day of the current month, adjusted for leap year.  The returned value is the numeric day index within the week (0-6) which can be used in conjunction with the {@link #monthNames} array to retrieve the textual day name.  Example:

var dt = new Date('1/10/2007');
Myna.println(Date.dayNames[dt.getLastDayOfMonth()]); //output: 'Wednesday'

Returns

{Number} The day number (0-6)

Date.prototype.getDaysInMonth = function()

Get the number of days in the current month, adjusted for leap year.

Returns

{Number} The number of days in the month

Date.prototype.getSuffix = function()

Get the English ordinal suffix of the current day (equivalent to the format specifier ‘S’).

Returns

{String} ‘st, ‘nd’, ‘rd’ or ‘th’

Date.prototype.clone = function()

Creates and returns a new Date instance with the exact same date value as the called instance.  Dates are copied and passed by reference, so if a copied date variable is modified later, the original variable will also be changed.  When the intention is to create a new variable that will not modify the original instance, you should create a clone.

Example of correctly cloning a date

//wrong way:
var orig = new Date('10/1/2006');
var copy = orig;
copy.setDate(5);
Myna.println(orig);  //returns 'Thu Oct 05 2006'!

//correct way:
var orig = new Date('10/1/2006');
var copy = orig.clone();
copy.setDate(5);
Myna.println(orig);  //returns 'Thu Oct 01 2006'

Returns

{Date} The new Date instance

Date.prototype.clearTime = function( clone )

Clears any time information from this date clone - {Boolean}true to create a clone of this date, clear the time and return it

Returns

{Date} this or the clone

Date.prototype.add = function( interval, value )

Provides a convenient method of performing basic date arithmetic.  This method does not modify the Date instance being called - it creates and returns a new Date instance containing the resulting date value.

Parameters

Date Interval Types

Returns

The new Date instance

Examples

//Basic usage:
var dt = new Date('10/29/2006').add(Date.DAY, 5);
Myna.println(dt); //returns 'Fri Oct 06 2006 00:00:00'

//can also use string codes:
var dt = new Date('10/29/2006').add("d", 5);
Myna.println(dt); //returns 'Fri Oct 06 2006 00:00:00'

//Or use an interval for applying to multiple dates
var interval = Date.getInterval("d",7) //one week
//add a week to all the dates in the 'preDefinedDates' array
var modifiedDates =preDefinedDates.map(function(date){
    return date.add(interval);
})


//Negative values will subtract correctly:
var dt2 = new Date('10/1/2006').add(Date.DAY, -5);
Myna.println(dt2); //returns 'Tue Sep 26 2006 00:00:00'

//You can even chain several calls together in one line!
var dt3 = new Date('10/1/2006').add(Date.DAY, 5).add(Date.HOUR, 8).add(Date.MINUTE, -30);
Myna.println(dt3); //returns 'Fri Oct 06 2006 07:30:00'

Date.diff=function( d1, d2, scale )

returns returns the time between two date objects

Parameters

Example

//return the difference in the d1 and d2 to the nearest week
Myna.println("Age: " + Math.round(Date.diff(create_date,new Date(),Date.WEEK)) );

Date.getInterval = function( interval, count )

returns a time interval in milliseconds.  This can be used with Date.add instead of specifying the type and length

Parameters

Date Interval Types

Note

• Date.MONTH is always 30 days
• Date.YEAR is always 365 days

Example

var interval = Date.getInterval("d",7) //one week
//add a week to all the dates in the 'preDefinedDates' array
var modifiedDates = preDefinedDates.map(function(date){
    return date.add(interval);
})

Date.parseInterval = function( interval )

returns an object with a breakdown of the units in an interval

Parameters

returned object properties

• milliSeconds
• seconds
• minutes
• hours
• days
• weeks
• years

Date.formatInterval = function( interval, options )

returns an interval in milliseconds as human readable string.

Parameters

Options

Styles

Example

var interval = new Date().getTime() - new Date().add(Date.DAY,-376).clearTime()

Myna.println(Date.formatInterval(interval))
//prints: 1 year, 1 week, 4 days, 10 hours, 11 minutes, 17 seconds, 332 milliseconds

Myna.println(Date.formatInterval(interval,{
    precision: Date.SECOND,
    scale:2,
    removeEmpty:false,
    sep:":",
    style:"none"
}))
//prints (year:weeks): 1:1

Date.monthsBetween = function( d1, d2 )

[static] returns the number of whole calendar months between two dates

Parameters

Note

if d1 > d2 the answer will be negative