+++ /dev/null
-/*
- Copyright (c) 2008, Adobe Systems Incorporated
- All rights reserved.
-
- Redistribution and use in source and binary forms, with or without
- modification, are permitted provided that the following conditions are
- met:
-
- * Redistributions of source code must retain the above copyright notice,
- this list of conditions and the following disclaimer.
-
- * Redistributions in binary form must reproduce the above copyright
- notice, this list of conditions and the following disclaimer in the
- documentation and/or other materials provided with the distribution.
-
- * Neither the name of Adobe Systems Incorporated nor the names of its
- contributors may be used to endorse or promote products derived from
- this software without specific prior written permission.
-
- THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
- IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
- THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- CONTRIBUTORS 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
- SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-*/
-
-package com.adobe.utils
-{
- 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
- * (referring to the 20th century) are fine, too.
- *
- * This function is useful for parsing RSS .91, .92, and 2.0 dates.
- *
- * @param str
- *
- * @returns
- *
- * @langversion ActionScript 3.0
- * @playerversion Flash 9.0
- * @tiptext
- *
- * @see http://asg.web.cmu.edu/rfc/rfc822.html
- */
- public static function parseRFC822(str:String):Date
- {
- var finalDate:Date;
- try
- {
- var dateParts:Array = str.split(" ");
- var day:String = null;
-
- if (dateParts[0].search(/\d/) == -1)
- {
- day = dateParts.shift().replace(/\W/, "");
- }
-
- var date:Number = Number(dateParts.shift());
- var month:Number = Number(DateUtil.getShortMonthIndex(dateParts.shift()));
- var year:Number = Number(dateParts.shift());
- var timeParts:Array = dateParts.shift().split(":");
- var hour:Number = int(timeParts.shift());
- var minute:Number = int(timeParts.shift());
- var second:Number = (timeParts.length > 0) ? int(timeParts.shift()): 0;
-
- var milliseconds:Number = Date.UTC(year, month, date, hour, minute, second, 0);
-
- var timezone:String = dateParts.shift();
- var offset:Number = 0;
-
- if (timezone.search(/\d/) == -1)
- {
- switch(timezone)
- {
- case "UT":
- offset = 0;
- break;
- case "UTC":
- offset = 0;
- break;
- case "GMT":
- offset = 0;
- break;
- case "EST":
- offset = (-5 * 3600000);
- break;
- case "EDT":
- offset = (-4 * 3600000);
- break;
- case "CST":
- offset = (-6 * 3600000);
- break;
- case "CDT":
- offset = (-5 * 3600000);
- break;
- case "MST":
- offset = (-7 * 3600000);
- break;
- case "MDT":
- offset = (-6 * 3600000);
- break;
- case "PST":
- offset = (-8 * 3600000);
- break;
- case "PDT":
- offset = (-7 * 3600000);
- break;
- case "Z":
- offset = 0;
- break;
- case "A":
- offset = (-1 * 3600000);
- break;
- case "M":
- offset = (-12 * 3600000);
- break;
- case "N":
- offset = (1 * 3600000);
- break;
- case "Y":
- offset = (12 * 3600000);
- break;
- default:
- offset = 0;
- }
- }
- else
- {
- var multiplier:Number = 1;
- var oHours:Number = 0;
- var oMinutes:Number = 0;
- if (timezone.length != 4)
- {
- if (timezone.charAt(0) == "-")
- {
- multiplier = -1;
- }
- timezone = timezone.substr(1, 4);
- }
- oHours = Number(timezone.substr(0, 2));
- oMinutes = Number(timezone.substr(2, 2));
- offset = (((oHours * 3600000) + (oMinutes * 60000)) * multiplier);
- }
-
- finalDate = new Date(milliseconds - offset);
-
- if (finalDate.toString() == "Invalid Date")
- {
- throw new Error("This date does not conform to RFC822.");
- }
- }
- catch (e:Error)
- {
- var eStr:String = "Unable to parse the string [" +str+ "] into a date. ";
- eStr += "The internal error was: " + e.toString();
- throw new Error(eStr);
- }
- return finalDate;
- }
-
- /**
- * Returns a date string formatted according to RFC822.
- *
- * @param d
- *
- * @returns
- *
- * @langversion ActionScript 3.0
- * @playerversion Flash 9.0
- * @tiptext
- *
- * @see http://asg.web.cmu.edu/rfc/rfc822.html
- */
- public static function toRFC822(d:Date):String
- {
- var date:Number = d.getUTCDate();
- var hours:Number = d.getUTCHours();
- var minutes:Number = d.getUTCMinutes();
- var seconds:Number = d.getUTCSeconds();
- var sb:String = new String();
- sb += DateBase.dayNamesShort[d.getUTCDay()];
- sb += ", ";
-
- if (date < 10)
- {
- sb += "0";
- }
- sb += date;
- sb += " ";
- //sb += DateUtil.SHORT_MONTH[d.getUTCMonth()];
- sb += DateBase.monthNamesShort[d.getUTCMonth()];
- sb += " ";
- sb += d.getUTCFullYear();
- sb += " ";
- if (hours < 10)
- {
- sb += "0";
- }
- sb += hours;
- sb += ":";
- if (minutes < 10)
- {
- sb += "0";
- }
- sb += minutes;
- sb += ":";
- if (seconds < 10)
- {
- sb += "0";
- }
- sb += seconds;
- sb += " GMT";
- return sb;
- }
-
- /**
- * Parses dates that conform to the W3C Date-time Format into Date objects.
- *
- * This function is useful for parsing RSS 1.0 and Atom 1.0 dates.
- *
- * @param str
- *
- * @returns
- *
- * @langversion ActionScript 3.0
- * @playerversion Flash 9.0
- * @tiptext
- *
- * @see http://www.w3.org/TR/NOTE-datetime
- */
- public static function parseW3CDTF(str:String):Date
- {
- var finalDate:Date;
- try
- {
- var dateStr:String = str.substring(0, str.indexOf("T"));
- var timeStr:String = str.substring(str.indexOf("T")+1, str.length);
- var dateArr:Array = dateStr.split("-");
- var year:Number = Number(dateArr.shift());
- var month:Number = Number(dateArr.shift());
- var date:Number = Number(dateArr.shift());
-
- var multiplier:Number;
- var offsetHours:Number;
- var offsetMinutes:Number;
- var offsetStr:String;
-
- if (timeStr.indexOf("Z") != -1)
- {
- multiplier = 1;
- offsetHours = 0;
- offsetMinutes = 0;
- timeStr = timeStr.replace("Z", "");
- }
- else if (timeStr.indexOf("+") != -1)
- {
- multiplier = 1;
- offsetStr = timeStr.substring(timeStr.indexOf("+")+1, timeStr.length);
- offsetHours = Number(offsetStr.substring(0, offsetStr.indexOf(":")));
- offsetMinutes = Number(offsetStr.substring(offsetStr.indexOf(":")+1, offsetStr.length));
- timeStr = timeStr.substring(0, timeStr.indexOf("+"));
- }
- else // offset is -
- {
- multiplier = -1;
- offsetStr = timeStr.substring(timeStr.indexOf("-")+1, timeStr.length);
- offsetHours = Number(offsetStr.substring(0, offsetStr.indexOf(":")));
- offsetMinutes = Number(offsetStr.substring(offsetStr.indexOf(":")+1, offsetStr.length));
- timeStr = timeStr.substring(0, timeStr.indexOf("-"));
- }
- var timeArr:Array = timeStr.split(":");
- var hour:Number = Number(timeArr.shift());
- var minutes:Number = Number(timeArr.shift());
- var secondsArr:Array = (timeArr.length > 0) ? String(timeArr.shift()).split(".") : null;
- var seconds:Number = (secondsArr != null && secondsArr.length > 0) ? Number(secondsArr.shift()) : 0;
- var milliseconds:Number = (secondsArr != null && secondsArr.length > 0) ? Number(secondsArr.shift()) : 0;
- var utc:Number = Date.UTC(year, month-1, date, hour, minutes, seconds, milliseconds);
- var offset:Number = (((offsetHours * 3600000) + (offsetMinutes * 60000)) * multiplier);
- finalDate = new Date(utc - offset);
-
- if (finalDate.toString() == "Invalid Date")
- {
- throw new Error("This date does not conform to W3CDTF.");
- }
- }
- catch (e:Error)
- {
- var eStr:String = "Unable to parse the string [" +str+ "] into a date. ";
- eStr += "The internal error was: " + e.toString();
- throw new Error(eStr);
- }
- return finalDate;
- }
-
- /**
- * Returns a date string formatted according to W3CDTF.
- *
- * @param d
- * @param includeMilliseconds Determines whether to include the
- * milliseconds value (if any) in the formatted string.
- *
- * @returns
- *
- * @langversion ActionScript 3.0
- * @playerversion Flash 9.0
- * @tiptext
- *
- * @see http://www.w3.org/TR/NOTE-datetime
- */
- public static function toW3CDTF(d:Date,includeMilliseconds:Boolean=false):String
- {
- var date:Number = d.getUTCDate();
- var month:Number = d.getUTCMonth();
- var hours:Number = d.getUTCHours();
- var minutes:Number = d.getUTCMinutes();
- var seconds:Number = d.getUTCSeconds();
- var milliseconds:Number = d.getUTCMilliseconds();
- var sb:String = new String();
-
- sb += d.getUTCFullYear();
- sb += "-";
-
- //thanks to "dom" who sent in a fix for the line below
- if (month + 1 < 10)
- {
- sb += "0";
- }
- sb += month + 1;
- sb += "-";
- if (date < 10)
- {
- sb += "0";
- }
- sb += date;
- sb += "T";
- if (hours < 10)
- {
- sb += "0";
- }
- sb += hours;
- sb += ":";
- if (minutes < 10)
- {
- sb += "0";
- }
- sb += minutes;
- sb += ":";
- if (seconds < 10)
- {
- sb += "0";
- }
- sb += seconds;
- if (includeMilliseconds && milliseconds > 0)
- {
- sb += ".";
- sb += milliseconds;
- }
- sb += "-00:00";
- return sb;
- }
-
- /**
- * Converts a date into just after midnight.
- */
- public static function makeMorning(d:Date):Date
- {
- var d:Date = new Date(d.time);
- d.hours = 0;
- d.minutes = 0;
- d.seconds = 0;
- d.milliseconds = 0;
- return d;
- }
-
- /**
- * Converts a date into just befor midnight.
- */
- public static function makeNight(d:Date):Date
- {
- var d:Date = new Date(d.time);
- d.hours = 23;
- d.minutes = 59;
- d.seconds = 59;
- d.milliseconds = 999;
- return d;
- }
-
- /**
- * Sort of converts a date into UTC.
- */
- public static function getUTCDate(d:Date):Date
- {
- var nd:Date = new Date();
- var offset:Number = d.getTimezoneOffset() * 60 * 1000;
- nd.setTime(d.getTime() + offset);
- return nd;
- }
- }
-}
fnp / redakcja.git / blobdiff