date.js

Browser independent JavaScript SDK. ClassLoader to lazy load JavaScript classes, extensions to core

/*
 * JavaScript Software Development Kit - what JavaScript should be and can be - js-sdk.sourceforge.net
 * Copyright (C) 2006-2007 Mathew Sheets
 *
 * == BEGIN LICENSE ==
 *
 * Licensed under the terms of any of the following licenses at your
 * choice:
 *
 *  - GNU Lesser General Public License Version 2.1 or later (the "LGPL")
 *    http://www.gnu.org/licenses/lgpl.html
 *
 * == END LICENSE ==
 */

class Date
{
	/**
	* @fileOverview
	* @example
	*/

	/**
	* The long version of the months, ex. January.
	*/
	Date.MONTH_NAMES = ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
	/**
	* The short verions of the months, ex. Jan.
	*/
	Date.MONTH_NAMES_SHORT = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];

	/**
	* The long verion of the days of the week, ex. Sunday.
	*/
	Date.DAY_NAMES = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
	/**
	* The short version of the days of the week, ex. Sun.
	*/
	Date.DAY_NAMES_SHORT = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];

	/**
	* The number of milliseconds in a day.
	*/
	Date.ONE_DAY_MILLISECONDS = 24 * 60 * 60 * 1000;
	/**
	* The number of milliseconds in a week.
	*/
	Date.ONE_WEEK_MILLISECONDS = 7 * Date.ONE_DAY_MILLISECONDS;

	/** @ignore */
	Date.DEFAULT_MINIMAL_DAYS_IN_FIRST_WEEK = 1;

	/**
	* Takes a date string and returns the number of milliseconds since midnight of January 1, 1970.
	* @name Date.parse
	* @param {String} _dateString A string representing a date.
	* @function
	*/
	/** @ignore */
	static _$parse$_(_dateString){throw "don't call me, used for reflection.";}
	/**
	* Takes a date and returns the number of milliseconds since midnight of January 1, 1970 according to universal time.
	* @name Datea.UTC
	* @param {Number} _year
	* @param {Number} _month
	* @param {Number} _day
	* @param {Number} [_hours]
	* @param {Number} [_minutes]
	* @param {Number} [_seconds]
	* @param {Number} [_ms]
	* @function
	*/
	/** @ignore */
	static _$UTC$_(_year, _month, _day, _hours, _minutes, _seconds, _ms){throw "don't call me, used for reflection.";}

	/**
	* Returns the day of the month from a Date object (from 1-31).
	* @name getDate
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getDate$_(){throw "don't call me, used for reflection.";}
	/**
	* Sets the day of the month in a Date object (from 1-31).
	* @name setDate
	* @param {Number} _date
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$setDate$_(_date){throw "don't call me, used for reflection.";}
	/**
	* Returns the day of the month from a Date object according to universal time (from 1-31).
	* @name getUTCDate
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getUTCDate$_(){throw "don't call me, used for reflection.";}
	/**
	* Sets the day of the month in a Date object according to universal time (from 1-31).
	* @name setUTCDate
	* @param {Number} _date
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$setUTCDate$_(_date){throw "don't call me, used for reflection.";}

	/**
	* Returns the day of the week from a Date object (from 0-6).
	* @name getDay
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getDay$_(){throw "don't call me, used for reflection.";}
	/**
	* Returns the day of the week from a Date object according to universal time (from 0-6).
	* @name getUTCDay
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getUTCDay$_(){throw "don't call me, used for reflection.";}

	/**
	* Returns the month from a Date object (from 0-11).
	* @name getMonth
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getMonth$_(){throw "don't call me, used for reflection.";}
	/**
	* Sets the month in a Date object (from 0-11).
	* @name setMonth
	* @param {Number} _month
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$setMonth$_(_month){throw "don't call me, used for reflection.";}
	/**
	* Returns the month from a Date object according to universal time (from 0-11).
	* @name getUTCMonth
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getUTCMonth$_(){throw "don't call me, used for reflection.";}
	/**
	* Sets the month in a Date object according to universal time (from 0-11).
	* @name setUTCMonth
	* @param {Number} _month
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$setUTCMonth$_(_month){throw "don't call me, used for reflection.";}

	/**
	* Returns the year, as a four-digit number, from a Date object.
	* @name getFullYear
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getFullYear$_(){throw "don't call me, used for reflection.";}
	/**
	* Sets the year in a Date object (four digits).
	* @name setFullYear
	* @param {Number} _fullYear
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$setFullYear$_(_fullYear){throw "don't call me, used for reflection.";}
	/**
	* Returns the four-digit year from a Date object according to universal time.
	* @name getUTCFullYear
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getUTCFullYear$_(){throw "don't call me, used for reflection.";}
	/**
	* Sets the year in a Date object according to universal time (four digits).
	* @name setUTCFullYear
	* @param {Number} _fullYear
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$setUTCFullYear$_(_fullYear){throw "don't call me, used for reflection.";}

	/**
	* Returns the year, as a two-digit or a four-digit number, from a Date object. Use getFullYear() instead!
	* @name getYear
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getYear$_(){throw "don't call me, used for reflection.";}
	/**
	* ets the year in the Date object (two or four digits). Use setFullYear() instead!
	* @name setYear
	* @param {Number} _year
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$setYear$_(_year){throw "don't call me, used for reflection.";}

	/**
	* Returns the hour of a Date object (from 0-23).
	* @name getHours
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getHours$_(){throw "don't call me, used for reflection.";}
	/**
	* Sets the hour in a Date object (from 0-23).
	* @name setHours
	* @param {Number} _year
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$setHours$_(_hours){throw "don't call me, used for reflection.";}
	/**
	* Returns the hour of a Date object according to universal time (from 0-23).
	* @name getUTCHours
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getUTCHours$_(){throw "don't call me, used for reflection.";}
	/**
	* Sets the hour in a Date object according to universal time (from 0-23).
	* @name setUTCHours
	* @param {Number} _hours
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$setUTCHours$_(_hours){throw "don't call me, used for reflection.";}

	/**
	* Returns the minutes of a Date object (from 0-59).
	* @name getMinutes
	* @return {Number}
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$getMinutes$_(){throw "don't call me, used for reflection.";}
	/**
	* Set the minutes in a Date object (from 0-59).
	* @name setMinutes
	* @param {Number} _minutes
	* @memberof Date
	* @function
	*/
	/** @ignore */
	instance _$setMinutes$_(_minutes){throw "don't call me, used for reflection.";}
	/**
	* Returns the minutes of a Date object according to universal time (from 0-59).
	* @name getUTCMinutes
	* @return {Number}
	* @memberof Date
	* @function
	*/