关键字: flex 学习项目中总结的时间处理工具类dateutils
package util{
import mx.formatters.DateFormatter; import mx.utils.ObjectUtil; import mx.utils.StringUtil;
public class DateUtils { // Days of week public static const MONDAY:String = "monday"; public static const TUESDAY:String = "tuesday"; public static const WEDNESDAY:String = "wednesday"; public static const THURSDAY:String = "thursday"; public static const FRIDAY:String = "friday"; public static const SATURDAY:String = "saturday"; public static const SUNDAY:String = "sunday"; // Months of year public static const JANUARY:String = "january"; public static const FEBRUARY:String = "february"; public static const MARCH:String = "march"; public static const APRIL:String = "april"; public static const MAY:String = "may"; public static const JUNE:String = "june"; public static const JULY:String = "july"; public static const AUGUST:String = "august"; public static const SEPTEMBER:String = "september"; public static const OCTOBER:String = "october"; public static const NOVEMBER:String = "november"; public static const DECEMBER:String = "december";
// Date parts public static const YEAR:String = "fullYear"; public static const MONTH:String = "month"; public static const WEEK:String = "week"; public static const DAY_OF_MONTH:String = "date"; public static const HOURS:String = "hours"; public static const MINUTES:String = "minutes"; public static const SECONDS:String = "seconds"; public static const MILLISECONDS:String = "milliseconds"; public static const DAY_OF_WEEK:String = "day"; // Numeric value of "last", to get last item for a specific time public static const LAST:Number = -1; // Date masks public static const SHORT_DATE_MASK:String = "MM/DD/YY"; public static const MEDIUM_DATE_MASK:String = "MMM D, YYYY"; public static const LONG_DATE_MASK:String = "MMMM D, YYYY"; public static const FULL_DATE_MASK:String = "EEEE, MMMM D, YYYY"; // Time masks public static const SHORT_TIME_MASK:String = "L:NN A"; public static const MEDIUM_TIME_MASK:String = "L:NN:SS A"; // TZD = TimeZoneDesignation = GMT + or - X hours, non-standard, requires a slight hack public static const LONG_TIME_MASK:String = MEDIUM_TIME_MASK + " TZD"; // Internal values for using in date/time calculations private static const SECOND_VALUE:uint = 1000; private static const MINUTE_VALUE:uint = DateUtils.SECOND_VALUE * 60; private static const HOUR_VALUE:uint = DateUtils.MINUTE_VALUE * 60; private static const DAY_VALUE:uint = DateUtils.HOUR_VALUE * 24; private static const WEEK_VALUE:uint = DateUtils.DAY_VALUE * 7; // Internal variable used in date/time formatting private static var _dateFormatter:DateFormatter; private static function get dateFormatter():DateFormatter { if ( !_dateFormatter ) { _dateFormatter = new DateFormatter; } return _dateFormatter; } // a generic object for holding day of the week values private static var _objDaysOfWeek:Object = null; public static function get objDaysOfWeek():Object { if ( !_objDaysOfWeek ) { _objDaysOfWeek = {}; _objDaysOfWeek[ DateUtils.SUNDAY ] = 0; _objDaysOfWeek[ DateUtils.MONDAY ] = 1; _objDaysOfWeek[ DateUtils.TUESDAY ] = 2; _objDaysOfWeek[ DateUtils.WEDNESDAY ] = 3; _objDaysOfWeek[ DateUtils.THURSDAY ] = 4; _objDaysOfWeek[ DateUtils.FRIDAY ] = 5; _objDaysOfWeek[ DateUtils.SATURDAY ] = 6; } return _objDaysOfWeek; } // a generic object for holding month values private static var _objMonth:Object = null; public static function get objMonth():Object { if ( !_objMonth ) { _objMonth = {}; _objMonth[ DateUtils.JANUARY ] = 0; _objMonth[ DateUtils.FEBRUARY ] = 1; _objMonth[ DateUtils.MARCH ] = 2; _objMonth[ DateUtils.APRIL ] = 3; _objMonth[ DateUtils.MAY ] = 4; _objMonth[ DateUtils.JUNE ] = 5; _objMonth[ DateUtils.JULY ] = 6; _objMonth[ DateUtils.AUGUST ] = 7; _objMonth[ DateUtils.SEPTEMBER ] = 8; _objMonth[ DateUtils.OCTOBER ] = 9; _objMonth[ DateUtils.NOVEMBER ] = 10; _objMonth[ DateUtils.DECEMBER ] = 11; } return _objMonth; } public function DateUtils() { } /** * * 添加或减少天数 */ public static function addDay(date:Date,days:int):Date { if(date!=null) { date.setDate(days); } return date; } /** * 两个日期相差的天数 * */ public static function daysOfDates(date0:Date,date1:Date):int { var days0:Number=date0.time; var days1:Number=date1.time; var days:Number=(days0-days1)/DAY_VALUE; return days; } /** * 判断时间是否在开始和结束时间之间 * */ public static function isBetween(fromdate:Date,todate:Date,current:Date):Boolean { if(ObjectUtil.dateCompare(fromdate,current)!==1&&ObjectUtil.dateCompare(todate,current)!=-1) { return true; } return false; } /** *位于某个时间之后 */ public static function after(date0:Date,date1:Date):Boolean { if(ObjectUtil.dateCompare(date0,date1)==1) { return true; } return false; } /** *位于某个时间之前 */ public static function before(date0:Date,date1:Date):Boolean { if(ObjectUtil.dateCompare(date0,date1)==-1) { return true; } return false; } /** *两个时间相等 */ public static function equals(date0:Date,date1:Date):Boolean { if(ObjectUtil.dateCompare(date0,date1)==0) { return true; } return false; } /** * @private * * This function will remove any invalid characters from the date/time mask based upon a pattern * * @param mask The string for matching * @param pattern The valid characters for this mask * @param defaultValue The default value to return to the calling page should the mask not match the pattern * * @return Returns a validated <code>mask</code> based upon the original pattern */ private static function removeInvalidDateTimeCharacters( mask:String, pattern:String, defaultValue:String ):String { // test for invalid date and time characters if ( mask.replace( new RegExp( pattern, "ig" ), "" ).length > 0 ) { // if user is passing an invalid mask, default to defaultValue mask = defaultValue; } // temporarily replace TZD with lowercase tzd for replacing later return mask.replace( new RegExp( "TZD", "i" ), "tzd" ); } /** * Formats a date into a certain date/time format * * @param date The date to format * @param mask How the date should be formatted * * @return A formatted date */ public static function dateTimeFormat( date:Date, mask:String="MM/DD/YYYY L:NN:SS A" ):String { return buildDateTime( date, mask, "(Y|M|D|E|A|J|H|K|L|N|S|TZD|//W)+", DateUtils.SHORT_DATE_MASK + ' ' + DateUtils.SHORT_TIME_MASK ); } /** * Formats a time into a certain time format * * @param date The date to format * @param mask How the date should be formatted * * @return A formatted time */ public static function timeFormat( date:Date, mask:String=DateUtils.SHORT_TIME_MASK ):String { return buildDateTime( date, mask, "(A|:|J|H|K|L|N|S|TZD|//s)+", DateUtils.SHORT_TIME_MASK ); } /** * Formats a date into a certain date format * * @param date The date to format * @param mask How the date should be formatted * * @return A formatted date */ public static function dateFormat( date:Date, mask:String=DateUtils.SHORT_DATE_MASK ):String { return buildDateTime( date, mask, "(Y|M|D|E|//W)+", DateUtils.SHORT_DATE_MASK ); } /** * @private * * Formats a date into a certain date/time format * * @param date The date to format * @param mask The string for matching * @param pattern The valid characters for this mask * @param defaultValue The default value to return to the calling page should the mask not match the pattern * * @return A formatted date */ private static function buildDateTime( date:Date, mask:String, pattern:String, defaultValue:String ):String { dateFormatter.formatString = removeInvalidDateTimeCharacters( mask, pattern, defaultValue ); return dateFormatter.format( date ).replace( new RegExp( "TZD", "i" ), buildTimeZoneDesignation( date ) ); } /** * @private * * Calculates a timeZoneOffset, and converts it to a string, in standard GMT XX:XX format * * @param date The date on which to calculate the offset * * @return The formatted time zone designation */ private static function buildTimeZoneDesignation( date:Date ):String { if ( !date ) { return ""; } var timeZoneAsString:String = "GMT "; // timezoneoffset is the number that needs to be added to the local time to get to GMT, so // a positive number would actually be GMT -X hours if ( date.getTimezoneOffset() / 60 > 0 && date.getTimezoneOffset() / 60 < 10 ) { timeZoneAsString += "-0" + ( date.getTimezoneOffset() / 60 ).toString(); } else if ( date.getTimezoneOffset() < 0 && date.timezoneOffset / 60 > -10 ) { timeZoneAsString += "0" + ( -1 * date.getTimezoneOffset() / 60 ).toString(); } // add zeros to match standard format timeZoneAsString += "00";
return timeZoneAsString; } /** * Adds the specified number of "date parts" to a date, e.g. 6 days * * @param datePart The part of the date that will be added * @param number The total number of "dateParts" to add to the date * @param date The date on which to add * * @return The new date */ public static function dateAdd( datePart:String, number:Number, date:Date ):Date { var _returnDate:Date = new Date( date ); switch ( datePart ) { case DateUtils.YEAR: case DateUtils.MONTH: case DateUtils.DAY_OF_MONTH: case DateUtils.HOURS: case DateUtils.MINUTES: case DateUtils.SECONDS: case DateUtils.MILLISECONDS: _returnDate[ datePart ] += number; break; case DateUtils.WEEK: _returnDate[ DateUtils.DAY_OF_MONTH ] += number * 7; break; default: /* Unknown date part, do nothing. */ break; } return _returnDate; } /** * Gets the day of the week * * @param date The date for which to get the day of the week * * @return A number representing the day of the week, 0 to 6 */ public static function dayOfWeek( date:Date ):Number { return date.getDay(); } /** * Gets the ordinal value or day of the year * * @param date The date for which to get the day of the year * * @return A number representing the day of the year, 1 to 365 or 366 for a leap year */ public static function dayOfYear( date:Date ):Number { // add one as it has to include first of year return DateUtils.dateDiff( DateUtils.DAY_OF_MONTH, new Date( date.fullYear, DateUtils.monthAsNumber( DateUtils.JANUARY ), 1 ), date ) + 1; } /** * Gets the week of the year * * @param date The date for which to get the week of the year * * @return A number representing the week of the year, 1 to 53 ( as there are slightly more than 52 weeks of days in a year) */ public static function weekOfYear( date:Date ):Number { return Math.ceil( DateUtils.dayOfYear( date ) / 7 ); } /** * Converts the day of the week to a Flex day of the week * * @param date The human readable day of week * * @return The Flex converted day of week or 0 aka Sunday */ public static function toFlexDayOfWeek( localDayOfWeek:Number ):Number { return ( localDayOfWeek > 0 && localDayOfWeek < 8 ) ? localDayOfWeek - 1 : 0; } /** * Gets the Xth day of the month. * e.g. get the 3rd Wednesday of the month * * @param iteration The iteration of the month to get e.g. 4th or Last * @param strDayOfWeek The day of the week as a string * @param date The date containing the month and year * * @return The date of the xth dayOfWeek of the month */ public static function dayOfWeekIterationOfMonth( iteration:Number, strDayOfWeek:String, date:Date ):Date { // get the numeric day of the week for the requested day var _dayOfWeek:Number = dayOfWeekAsNumber( strDayOfWeek ); // get the date for the first of the month var _firstOfMonth:Date = new Date( date.fullYear, date.month, 1 ); // calculate how many days to add to get to the requested day from the first of the month var _daysToAdd:Number = _dayOfWeek - DateUtils.dayOfWeek( _firstOfMonth ); // if dayOfWeek is before the first of the month, get the dayOfWeek for the following week if ( _daysToAdd < 0 ) { _daysToAdd += 7; } // set the date to the first day of the week for the requested date var _firstDayOfWeekOfMonth:Date = DateUtils.dateAdd( DateUtils.DAY_OF_MONTH, _daysToAdd, _firstOfMonth ); // return the date if iteration is 1 if ( iteration == 1 ) { return _firstDayOfWeekOfMonth; } else { // if requesting an iteration that is more than is in that month or requesting the last day of week of month // return last date for that day of week of month if ( ( DateUtils.totalDayOfWeekInMonth( strDayOfWeek, date ) < iteration ) || ( iteration == DateUtils.LAST ) ) { iteration = DateUtils.totalDayOfWeekInMonth( strDayOfWeek, date ); } // subtract 1 as it starts from the first dayOfWeek of month return DateUtils.dateAdd( DateUtils.WEEK, iteration - 1, _firstDayOfWeekOfMonth ); } } /** * Gets the days in the month * * @param date The date to check * * @return The number of days in the month */ public static function daysInMonth( date:Date ):Number { // get the first day of the next month var _localDate:Date = new Date( date.fullYear, DateUtils.dateAdd( DateUtils.MONTH, 1, date ).month, 1 ); // subtract 1 day to get the last day of the requested month return DateUtils.dateAdd( DateUtils.DAY_OF_MONTH, -1, _localDate ).date; } /** * Gets the total number of dayOfWeek in the month * * @param strDayOfWeek The day of week to check * @param date The date containing the month and year * * @return The number of <code>strDayOfWeek</code> in that month and year */ public static function totalDayOfWeekInMonth( strDayOfWeek:String, date:Date ):Number { var _startDate:Date = DateUtils.dayOfWeekIterationOfMonth( 1, strDayOfWeek, date ); var _totalDays:Number = DateUtils.dateDiff( DateUtils.DAY_OF_MONTH, _startDate, new Date( date.fullYear, date.month, DateUtils.daysInMonth( date ) ) ); // have to add 1 because have to include first day that is found i.e. if wed is on 2nd of 31 day month, would total 5, of if wed on 6th, would total 4 return Math.floor( _totalDays / 7 ) + 1; } /** * Converts the month to a Flex month * * @param date The human readable month * * @return The Flex converted month or 0 aka January */ public static function toFlexMonth( localMonth:Number ):Number { return ( localMonth > 0 && localMonth < 13 ) ? localMonth - 1 : 0; } /** * Determines whether a value is actually a valid date * * @param value The date value * * @return <code>true</code> means this is a valid date, <code>false</code> means it is not a valid date */ public static function isDate( value:String ):Boolean { return Date.parse( value ) > 0; } /** * Formats a date to the string version of the day of the week * * @param date The date to format * * @return A formatted day of week */ public static function dayOfWeekAsString( date:Date ):String { return DateUtils.dateFormat( date, "EEEE" ); } /** * Formats a date to the numeric version of the day of the week * * @param strDayOfWeek The day of week to convert * * @return A formatted day of week or -1 if day not found */ public static function dayOfWeekAsNumber( strDayOfWeek:String ):Number { return ( objDaysOfWeek[ strDayOfWeek ] >= 0 ) ? objDaysOfWeek[ strDayOfWeek ] : -1; } /** * Formats a date to the string version of the month * * @param date The date to format * * @return A formatted month */ public static function monthAsString( date:Date ):String { return DateUtils.dateFormat( date, "MMMM" ); } /** * Formats a month to the numeric version of the month * * @param strMonth The month to convert * * @return A formatted month or -1 if month not found */ public static function monthAsNumber( strMonth:String ):Number { return ( objMonth[ strMonth ] >= 0 ) ? objMonth[ strMonth ] : -1; } /** * Gets the number of days in the year * * @param date The date to check * * @return The total number of days in the year */ public static function daysInYear( date:Date ):Number { return DateUtils.dateDiff( DateUtils.DAY_OF_MONTH, new Date( date.fullYear, DateUtils.monthAsNumber( DateUtils.JANUARY ), 1 ), DateUtils.dateAdd( DateUtils.YEAR, 1, new Date( date.fullYear, DateUtils.monthAsNumber( DateUtils.JANUARY ), 1 ) ) ); } /** * Determines whether the year is a leap year or not * * @param date The date to check * * @return <code>true</code> means it is a leap year, <code>false</code> means it is not a leap year. */ public static function isLeapYear( date:Date ):Boolean { return daysInYear( date ) > 365; } /** * Determines the number of "dateParts" difference between 2 dates * * @param datePart The part of the date that will be checked * @param startDate The starting date * @param endDate The ending date * * @return The number of "dateParts" difference */ public static function dateDiff( datePart:String, startDate:Date, endDate:Date ):Number { var _returnValue:Number = 0;
switch ( datePart ) { case DateUtils.MILLISECONDS: _returnValue = endDate.time - startDate.time; break; case DateUtils.SECONDS: _returnValue = Math.floor( DateUtils.dateDiff( DateUtils.MILLISECONDS, startDate, endDate ) / DateUtils.SECOND_VALUE ); break; case DateUtils.MINUTES: _returnValue = Math.floor( DateUtils.dateDiff( DateUtils.MILLISECONDS, startDate, endDate ) / DateUtils.MINUTE_VALUE ); break; case DateUtils.HOURS: _returnValue = Math.floor( DateUtils.dateDiff( DateUtils.MILLISECONDS, startDate, endDate ) / DateUtils.HOUR_VALUE ); break; case DateUtils.DAY_OF_MONTH: // TODO: Need to figure out DST problem i.e. 23 hours at DST start, 25 at end. // Math.floor causes rounding down error with DST start at dayOfYear _returnValue = Math.floor( DateUtils.dateDiff( DateUtils.MILLISECONDS, startDate, endDate ) / DateUtils.DAY_VALUE ); break; case DateUtils.WEEK: _returnValue = Math.floor( DateUtils.dateDiff( DateUtils.MILLISECONDS, startDate, endDate ) / DateUtils.WEEK_VALUE ); break; case DateUtils.MONTH: // if start date is after end date, switch values and take inverse of return value if ( DateUtils.dateDiff( DateUtils.MILLISECONDS, startDate, endDate ) < 0 ) { _returnValue -= DateUtils.dateDiff( DateUtils.MONTH, endDate, startDate ); } else { // get number of months based upon years _returnValue = DateUtils.dateDiff( DateUtils.YEAR, startDate, endDate ) * 12; // subtract months then perform test to verify whether to subtract one month or not // the check below gets the correct starting number of months (but may need to have one month removed after check) if ( endDate.month != startDate.month ) { _returnValue += ( endDate.month <= startDate.month ) ? 12 - startDate.month + endDate.month : endDate.month - startDate.month; } // have to perform same checks as YEAR // i.e. if end date day is <= start date day, and end date milliseconds < start date milliseconds if ( ( endDate[ DateUtils.DAY_OF_MONTH ] < startDate[ DateUtils.DAY_OF_MONTH ] ) || ( endDate[ DateUtils.DAY_OF_MONTH ] == startDate[ DateUtils.DAY_OF_MONTH ] && endDate[ DateUtils.MILLISECONDS ] < startDate[ DateUtils.MILLISECONDS ] ) ) { _returnValue -= 1; } } break; case DateUtils.YEAR: _returnValue = endDate.fullYear - startDate.fullYear; // this fixes the previous problem with dates that ran into 2 calendar years // previously, if 2 dates were in separate calendar years, but the months were not > 1 year apart, then it was returning too many years // e.g. 11/2008 to 2/2009 was returning 1, but should have been returning 0 (zero) // if start date before end date and months are less than 1 year apart, add 1 to year to fix offset issue // if end date before start date and months are less than 1 year apart, subtract 1 year to fix offset issue // added month and milliseconds check to make sure that a date that was e.g. 9/11/07 9:15AM would not return 1 year if the end date was 9/11/08 9:14AM if ( _returnValue != 0 ) { // if start date is after end date if ( _returnValue < 0 ) { // if end date month is >= start date month, and end date day is >= start date day, and end date milliseconds > start date milliseconds if ( ( endDate[ DateUtils.MONTH ] > startDate[ DateUtils.MONTH ] ) || ( endDate[ DateUtils.MONTH ] == startDate[ DateUtils.MONTH ] && endDate[ DateUtils.DAY_OF_MONTH ] > startDate[ DateUtils.DAY_OF_MONTH ] ) || ( endDate[ DateUtils.MONTH ] == startDate[ DateUtils.MONTH ] && endDate[ DateUtils.DAY_OF_MONTH ] == startDate[ DateUtils.DAY_OF_MONTH ] && endDate[ DateUtils.MILLISECONDS ] > startDate[ DateUtils.MILLISECONDS ] ) ) { _returnValue += 1; } } else { // if end date month is <= start date month, and end date day is <= start date day, and end date milliseconds < start date milliseconds if ( ( endDate[ DateUtils.MONTH ] < startDate[ DateUtils.MONTH ] ) || ( endDate[ DateUtils.MONTH ] == startDate[ DateUtils.MONTH ] && endDate[ DateUtils.DAY_OF_MONTH ] < startDate[ DateUtils.DAY_OF_MONTH ] ) || ( endDate[ DateUtils.MONTH ] == startDate[ DateUtils.MONTH ] && endDate[ DateUtils.DAY_OF_MONTH ] == startDate[ DateUtils.DAY_OF_MONTH ] && endDate[ DateUtils.MILLISECONDS ] < startDate[ DateUtils.MILLISECONDS ] ) ) { _returnValue -= 1; } } } break; }
return _returnValue; } } }
