/*	Adobe Systems Incorporated(r) Source Code License Agreement	Copyright(c) 2005 Adobe Systems Incorporated. All rights reserved.		Please read this Source Code License Agreement carefully before using	the source code.		Adobe Systems Incorporated grants to you a perpetual, worldwide, non-exclusive, 	no-charge, royalty-free, irrevocable copyright license, to reproduce,	prepare derivative works of, publicly display, publicly perform, and	distribute this source code and such derivative works in source or 	object code form without any attribution requirements.  		The name "Adobe Systems Incorporated" must not be used to endorse or promote products	derived from the source code without prior written permission.		You agree to indemnify, hold harmless and defend Adobe Systems Incorporated from and	against any loss, damage, claims or lawsuits, including attorney's 	fees that arise or result from your use or distribution of the source 	code.		THIS SOURCE CODE IS PROVIDED "AS IS" AND "WITH ALL FAULTS", WITHOUT 	ANY TECHNICAL SUPPORT OR ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING,	BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS	FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  ALSO, THERE IS NO WARRANTY OF 	NON-INFRINGEMENT, TITLE OR QUIET ENJOYMENT.  IN NO EVENT SHALL MACROMEDIA	OR ITS SUPPLIERS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,	EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 	PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;	OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 	WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 	OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOURCE CODE, EVEN IF	ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.*/package com.adobe.utils{	import com.adobe.utils.ArrayUtil;	import mx.formatters.DateBase;	/**	* 	Class that contains static utility methods for manipulating and working	*	with Dates.	* 	* 	@langversion ActionScript 3.0	*	@playerversion Flash 9.0	*	@tiptext	*/		public class DateUtil	{			/**		*	Returns the English Short Month name (3 letters) for the Month that		*	the Date represents.  			* 		* 	@param d The Date instance whose month will be used to retrieve the		*	short month name.		* 		* 	@return An English 3 Letter Month abbreviation.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*		*	@see SHORT_MONTH		*/			public static function getShortMonthName(d:Date):String		{			return DateBase.monthNamesShort[d.getMonth()];		}		/**		*	Returns the index of the month that the short month name string		*	represents. 			* 		* 	@param m The 3 letter abbreviation representing a short month name.		*		*	@param Optional parameter indicating whether the search should be case		*	sensitive		* 		* 	@return A int that represents that month represented by the specifed		*	short name.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*		*	@see SHORT_MONTH		*/			public static function getShortMonthIndex(m:String):int		{			return DateBase.monthNamesShort.indexOf(m);		}				/**		*	Returns the English full Month name for the Month that		*	the Date represents.  			* 		* 	@param d The Date instance whose month will be used to retrieve the		*	full month name.		* 		* 	@return An English full month name.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*		*	@see FULL_MONTH		*/			public static function getFullMonthName(d:Date):String		{			return DateBase.monthNamesLong[d.getMonth()];			}		/**		*	Returns the index of the month that the full month name string		*	represents. 			* 		* 	@param m A full month name.		* 		* 	@return A int that represents that month represented by the specifed		*	full month name.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*		*	@see FULL_MONTH		*/			public static function getFullMonthIndex(m:String):int		{			return DateBase.monthNamesLong.indexOf(m);		}		/**		*	Returns the English Short Day name (3 letters) for the day that		*	the Date represents.  			* 		* 	@param d The Date instance whose day will be used to retrieve the		*	short day name.		* 		* 	@return An English 3 Letter day abbreviation.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*		*	@see SHORT_DAY		*/			public static function getShortDayName(d:Date):String		{			return DateBase.dayNamesShort[d.getDay()];			}				/**		*	Returns the index of the day that the short day name string		*	represents. 			* 		* 	@param m A short day name.		* 		* 	@return A int that represents that short day represented by the specifed		*	full month name.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*		*	@see SHORT_DAY		*/					public static function getShortDayIndex(d:String):int		{			return DateBase.dayNamesShort.indexOf(d);		}		/**		*	Returns the English full day name for the day that		*	the Date represents.  			* 		* 	@param d The Date instance whose day will be used to retrieve the		*	full day name.		* 		* 	@return An English full day name.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*		*	@see FULL_DAY		*/			public static function getFullDayName(d:Date):String		{			return DateBase.dayNamesLong[d.getDay()];			}				/**		*	Returns the index of the day that the full day name string		*	represents. 			* 		* 	@param m A full day name.		* 		* 	@return A int that represents that full day represented by the specifed		*	full month name.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*		*	@see FULL_DAY		*/				public static function getFullDayIndex(d:String):int		{			return DateBase.dayNamesLong.indexOf(d);		}		/**		*	Returns a two digit representation of the year represented by the 		*	specified date.		* 		* 	@param d The Date instance whose year will be used to generate a two		*	digit string representation of the year.		* 		* 	@return A string that contains a 2 digit representation of the year.		*	Single digits will be padded with 0.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*/			public static function getShortYear(d:Date):String		{			var dStr:String = String(d.getFullYear());						if(dStr.length < 3)			{				return dStr;			}			return (dStr.substr(dStr.length - 2));		}		/**		*	Compares two dates and returns an integer depending on their relationship.		*		*	Returns -1 if d1 is greater than d2.		*	Returns 1 if d2 is greater than d1.		*	Returns 0 if both dates are equal.		* 		* 	@param d1 The date that will be compared to the second date.		*	@param d2 The date that will be compared to the first date.		* 		* 	@return An int indicating how the two dates compare.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*/			public static function compareDates(d1:Date, d2:Date):int		{			var d1ms:Number = d1.getTime();			var d2ms:Number = d2.getTime();						if(d1ms > d2ms)			{				return -1;			}			else if(d1ms < d2ms)			{				return 1;			}			else			{				return 0;			}		}		/**		*	Returns a short hour (0 - 12) represented by the specified date.		*		*	If the hour is less than 12 (0 - 11 AM) then the hour will be returned.		*		*	If the hour is greater than 12 (12 - 23 PM) then the hour minus 12		*	will be returned.		* 		* 	@param d1 The Date from which to generate the short hour		* 		* 	@return An int between 0 and 13 ( 1 - 12 ) representing the short hour.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*/			public static function getShortHour(d:Date):int		{			var h:int = d.hours;						if(h == 0 || h == 12)			{				return 12;			}			else if(h > 12)			{				return h - 12;			}			else			{				return h;			}		}				/**		*	Returns a string indicating whether the date represents a time in the		*	ante meridiem (AM) or post meridiem (PM).		*		*	If the hour is less than 12 then "AM" will be returned.		*		*	If the hour is greater than 12 then "PM" will be returned.		* 		* 	@param d1 The Date from which to generate the 12 hour clock indicator.		* 		* 	@return A String ("AM" or "PM") indicating which half of the day the 		*	hour represents.		*		* 	@langversion ActionScript 3.0		*	@playerversion Flash 9.0		*	@tiptext		*/			public static function getAMPM(d:Date):String		{			return (d.hours > 11)? "PM" : "AM";		}		/**		* Parses dates that conform to RFC822 into Date objects. This method also		* supports four-digit years (not supported in RFC822), but two-digit years