jidefx.utils

Class DateUtils

java.lang.Object

jidefx.utils.DateUtils

public class DateUtils
extends java.lang.Object

DateUtils contains many useful methods related to Date and Calendar.

Constructor Summary

Constructors

Constructor and Description
DateUtils()

Method Summary

Modifier and Type	Method and Description
static java.util.Calendar	adjustDate(java.util.Calendar calendar, int differenceInDay) Adjusts the Calendar to several days before or after the current date.
static boolean	isAtMonth(java.util.Calendar cal, int month) Checks if the calendar object is in the specified month, regardless of the year.
static boolean	isAtQuarter(java.util.Calendar cal, int quarter) Checks if the calendar object is in the specified quarter, regardless of the year.
static boolean	isLastMonth(java.util.Calendar cal) Checks if the calendar object is last month.
static boolean	isLastQuarter(java.util.Calendar cal) Checks if the calendar object is last quarter.
static boolean	isLastWeek(java.util.Calendar cal) Checks if the calendar object is last week.
static boolean	isLastYear(java.util.Calendar cal) Checks if the calendar object is last year.
static boolean	isNextMonth(java.util.Calendar cal) Checks if the calendar object is next month.
static boolean	isNextQuarter(java.util.Calendar cal) Checks if the calendar object is next quarter.
static boolean	isNextWeek(java.util.Calendar cal) Checks if the calendar object is next week.
static boolean	isNextYear(java.util.Calendar cal) Checks if the calendar object is next year.
static boolean	isThisMonth(java.util.Calendar cal) Checks if the calendar object is same month as today.
static boolean	isThisQuarter(java.util.Calendar cal) Checks if the calendar object is same quarter as today.
static boolean	isThisWeek(java.util.Calendar cal) Checks if the calendar object is same week as today.
static boolean	isThisYear(java.util.Calendar cal) Checks if the calendar object is same year as today.
static boolean	isToday(java.util.Calendar cal) Checks if the calendar object is same date as today.
static boolean	isTomorrow(java.util.Calendar cal) Checks if the calendar object is same date as tomorrow.
static boolean	isYesterday(java.util.Calendar cal) Checks if the calendar object is same date as yesterday.
static java.util.Date	max(java.util.List<java.util.Date> dates) Deprecated. replaced by maxDates(java.util.List) to comply with the new compilation regulation. We have to delete the max(List) in releases earlier than 2.9.4 due to the same reason.
static java.util.Calendar	maxCalendars(java.util.List<java.util.Calendar> calendars) Returns the maximum Calendar in the Calendar list.
static java.util.Date	maxDates(java.util.List<java.util.Date> dates) Returns the maximum Date in the Date list.
static java.util.Date	min(java.util.List<java.util.Date> dates) Deprecated. replaced by minDates(java.util.List) to comply with the new compilation regulation. We have to delete the min(List) in releases earlier than 2.9.4 due to the same reason.
static java.util.Calendar	minCalendars(java.util.List<java.util.Calendar> calendars) Returns the minimum Calendar in the Calendar list.
static java.util.Date	minDates(java.util.List<java.util.Date> dates) Returns the minimum Date in the Date list.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DateUtils

public DateUtils()

Method Detail

isToday

public static boolean isToday(java.util.Calendar cal)

Checks if the calendar object is same date as today.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is the same date as today.

isThisWeek

public static boolean isThisWeek(java.util.Calendar cal)

Checks if the calendar object is same week as today.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is the same week as today.

isThisMonth

public static boolean isThisMonth(java.util.Calendar cal)

Checks if the calendar object is same month as today.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is the same month as today.

isThisQuarter

public static boolean isThisQuarter(java.util.Calendar cal)

Checks if the calendar object is same quarter as today.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is the same quarter as today.

isThisYear

public static boolean isThisYear(java.util.Calendar cal)

Checks if the calendar object is same year as today.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is the same year as today.

isYesterday

public static boolean isYesterday(java.util.Calendar cal)

Checks if the calendar object is same date as yesterday.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is the same date as yesterday.

isLastWeek

public static boolean isLastWeek(java.util.Calendar cal)

Checks if the calendar object is last week.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is last week.

isLastMonth

public static boolean isLastMonth(java.util.Calendar cal)

Checks if the calendar object is last month.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is last month.

isLastQuarter

public static boolean isLastQuarter(java.util.Calendar cal)

Checks if the calendar object is last quarter.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is last quarter.

isLastYear

public static boolean isLastYear(java.util.Calendar cal)

Checks if the calendar object is last year.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is last year.

isTomorrow

public static boolean isTomorrow(java.util.Calendar cal)

Checks if the calendar object is same date as tomorrow.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is the same date as tomorrow.

isNextWeek

public static boolean isNextWeek(java.util.Calendar cal)

Checks if the calendar object is next week.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is next week.

isNextMonth

public static boolean isNextMonth(java.util.Calendar cal)

Checks if the calendar object is next month.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is next month.

isNextQuarter

public static boolean isNextQuarter(java.util.Calendar cal)

Checks if the calendar object is next quarter.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is next quarter.

isNextYear

public static boolean isNextYear(java.util.Calendar cal)

Checks if the calendar object is next year.

Parameters:

cal - the calendar object

Returns:

true if the calendar object is next year.

isAtMonth

public static boolean isAtMonth(java.util.Calendar cal,
                                int month)

Checks if the calendar object is in the specified month, regardless of the year.

Parameters:

cal - the calendar object.

month - the month, starting from 0 for January. You can use the value defined in Calendar such as Calendar.JANUARY, Calendar.FEBRUARY, etc.

Returns:

true if the calendar object is the specified month.

isAtQuarter

public static boolean isAtQuarter(java.util.Calendar cal,
                                  int quarter)

Checks if the calendar object is in the specified quarter, regardless of the year.

Parameters:

cal - the calendar object.

quarter - the quarter, starting from 1 for the first quarter (including January, February, and March).

Returns:

true if the calendar object is the specified quarter.

adjustDate

public static java.util.Calendar adjustDate(java.util.Calendar calendar,
                                            int differenceInDay)

Adjusts the Calendar to several days before or after the current date.

Parameters:

calendar - the Calendar object to be adjusted.

differenceInDay - the difference in days. It accepts both position and negative number.

Returns:

the calendar after the adjustment. It should always be the same instance as the calendar parameter.

min

@Deprecated
public static java.util.Date min(java.util.List<java.util.Date> dates)

Deprecated. replaced by minDates(java.util.List) to comply with the new compilation regulation. We have to delete the min(List) in releases earlier than 2.9.4 due to the same reason.

Returns the minimum Date in the Date list.

Parameters:

dates - the list of Date to calculate the minimum.

Returns:

the minimum date in the Date list.

max

@Deprecated
public static java.util.Date max(java.util.List<java.util.Date> dates)

Deprecated. replaced by maxDates(java.util.List) to comply with the new compilation regulation. We have to delete the max(List) in releases earlier than 2.9.4 due to the same reason.

Returns the maximum Date in the Date list.

Parameters:

dates - the list of Date to calculate the maximum.

Returns:

the maximum date in the Date list.

minDates

public static java.util.Date minDates(java.util.List<java.util.Date> dates)

Returns the minimum Date in the Date list.

Parameters:

dates - the list of Date to calculate the minimum.

Returns:

the minimum date in the Date list.

maxDates

public static java.util.Date maxDates(java.util.List<java.util.Date> dates)

Returns the maximum Date in the Date list.

Parameters:

dates - the list of Date to calculate the maximum.

Returns:

the maximum date in the Date list.

minCalendars

public static java.util.Calendar minCalendars(java.util.List<java.util.Calendar> calendars)

Returns the minimum Calendar in the Calendar list.

Parameters:

calendars - the list of Calendar to calculate the minimum.

Returns:

the minimum calendar in the Calendar list.

maxCalendars

public static java.util.Calendar maxCalendars(java.util.List<java.util.Calendar> calendars)

Returns the maximum Calendar in the Calendar list.

Parameters:

calendars - the list of Calendar to calculate the maximum.

Returns:

the maximum calendar in the Calendar list.