|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.jdesktop.swingx.calendar.CalendarUtils
public class CalendarUtils
Calendar manipulation. PENDING: replace by something tested - as is c&p'ed dateUtils to work on a calendar instead of using long
Field Summary | |
---|---|
static int |
DECADE
|
static int |
ONE_DAY
|
static int |
ONE_HOUR
|
static int |
ONE_MINUTE
|
static int |
THREE_HOURS
|
static int |
YEAR_IN_DECADE
|
Constructor Summary | |
---|---|
CalendarUtils()
|
Method Summary | |
---|---|
static void |
add(java.util.Calendar calendar,
int field,
int amount)
Increments the calendar field of the given calendar by amount. |
static boolean |
areEqual(java.util.Date current,
java.util.Date date)
Checks the given dates for being equal. |
static void |
endOfDay(java.util.Calendar calendar)
Adjust the given calendar to the last millisecond of the specified date. |
static java.util.Date |
endOfDay(java.util.Calendar calendar,
java.util.Date date)
Adjust the given calendar to the last millisecond of the given date. |
static void |
endOfMonth(java.util.Calendar calendar)
Adjusts the calendar to the end of the current month. |
static void |
endOfWeek(java.util.Calendar calendar)
Adjusts the calendar to the end of the current week. |
static java.util.Date |
endOfWeek(java.util.Calendar calendar,
java.util.Date date)
Adjusts the calendar to the end of the current week. |
static int |
get(java.util.Calendar calendar,
int field)
Gets the calendar field of the given calendar by amount. |
static java.util.Date |
getEndOfDST(java.util.Calendar calendar)
Adjusts the Calendar to the end of the day of the last day in DST in the current year or unchanged if not using DST. |
static java.util.Date |
getStartOfDST(java.util.Calendar calendar)
Adjusts the Calendar to the end of the day of the first day in DST in the current year or unchanged if not using DST. |
static boolean |
isEndOfDay(java.util.Calendar calendar)
Returns a boolean indicating if the given calendar represents the end of a day (in the calendar's time zone). |
static boolean |
isEndOfMonth(java.util.Calendar calendar)
Returns a boolean indicating if the given calendar represents the end of a month (in the calendar's time zone). |
static boolean |
isEndOfWeek(java.util.Calendar calendar)
Returns a boolean indicating if the given calendar represents the end of a week (in the calendar's time zone). |
static boolean |
isFlushed(java.util.Calendar calendar)
Returns a boolean to indicate whether the given calendar is flushed. |
static boolean |
isSame(java.util.Calendar today,
java.util.Date now,
int field)
Returns a boolean indicating whether the given Date is in the same period as the Date in the calendar, as defined by the calendar field. |
static boolean |
isSameDay(java.util.Calendar today,
java.util.Date now)
Returns a boolean indicating whether the given Date is the same day as the day in the calendar. |
static boolean |
isStartOf(java.util.Calendar calendar,
int field)
Returns a boolean indicating if the calendar is set to the start of a period as defined by the given field. |
static boolean |
isStartOfDay(java.util.Calendar calendar)
Returns a boolean indicating if the given calendar represents the start of a day (in the calendar's time zone). |
static boolean |
isStartOfDecade(java.util.Calendar calendar)
Returns a boolean indicating if the given calendar represents the start of a year (in the calendar's time zone). |
static boolean |
isStartOfMonth(java.util.Calendar calendar)
Returns a boolean indicating if the given calendar represents the start of a month (in the calendar's time zone). |
static boolean |
isStartOfWeek(java.util.Calendar calendar)
Returns a boolean indicating if the given calendar represents the start of a month (in the calendar's time zone). |
static boolean |
isStartOfYear(java.util.Calendar calendar)
Returns a boolean indicating if the given calendar represents the start of a year (in the calendar's time zone). |
static void |
set(java.util.Calendar calendar,
int field,
int value)
Sets the calendar field of the given calendar by amount. |
static void |
startOf(java.util.Calendar calendar,
int field)
Adjusts the given calendar to the start of the period as indicated by the given field. |
static void |
startOfDay(java.util.Calendar calendar)
Adjust the given calendar to the first millisecond of the current day. |
static java.util.Date |
startOfDay(java.util.Calendar calendar,
java.util.Date date)
Adjust the given calendar to the first millisecond of the given date. |
static void |
startOfDecade(java.util.Calendar calendar)
Adjusts the given Calendar to the start of the year. |
static java.util.Date |
startOfDecade(java.util.Calendar calendar,
java.util.Date date)
Adjusts the given Calendar to the start of the decade as defined by the given date. |
static void |
startOfMonth(java.util.Calendar calendar)
Adjusts the calendar to the start of the current month. |
static void |
startOfWeek(java.util.Calendar calendar)
Adjusts the calendar to the start of the current week. |
static java.util.Date |
startOfWeek(java.util.Calendar calendar,
java.util.Date date)
Adjusts the calendar to the start of the current week. |
static void |
startOfYear(java.util.Calendar calendar)
Adjusts the given Calendar to the start of the year. |
static java.util.Date |
startOfYear(java.util.Calendar calendar,
java.util.Date date)
Adjusts the given Calendar to the start of the year as defined by the given date. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final int ONE_MINUTE
public static final int ONE_HOUR
public static final int THREE_HOURS
public static final int ONE_DAY
public static final int DECADE
public static final int YEAR_IN_DECADE
Constructor Detail |
---|
public CalendarUtils()
Method Detail |
---|
public static void add(java.util.Calendar calendar, int field, int amount)
calendar
- field
- the field to increment, allowed are all fields known to
Calendar plus DECADE.amount
-
java.lang.IllegalArgumentException
public static int get(java.util.Calendar calendar, int field)
calendar
- field
- the field to get, allowed are all fields known to
Calendar plus DECADE.
java.lang.IllegalArgumentException
public static void set(java.util.Calendar calendar, int field, int value)
NOTE: the custom field implementations are very naive (JSR-310 will do better) - for decade: value must be positive, value must be a multiple of 10 and is interpreted as the first-year-of-the-decade - for year-in-decade: value is added/substracted to/from the start-of-decade of the date of the given calendar
calendar
- field
- the field to increment, allowed are all fields known to
Calendar plus DECADE.value
- the decade to set, must be a
java.lang.IllegalArgumentException
- if the field is unsupported or the value is
not dividable by 10 or negative.public static java.util.Date getEndOfDST(java.util.Calendar calendar)
calendar
- the calendar to adjust
public static java.util.Date getStartOfDST(java.util.Calendar calendar)
Note: the start of the day of the first day in DST is ill-defined!
calendar
- the calendar to adjust
public static boolean isStartOfDay(java.util.Calendar calendar)
calendar
- the calendar to check.
public static boolean isEndOfDay(java.util.Calendar calendar)
calendar
- the calendar to check.
public static boolean isStartOfMonth(java.util.Calendar calendar)
calendar
- the calendar to check.
public static boolean isEndOfMonth(java.util.Calendar calendar)
calendar
- the calendar to check.
public static boolean isStartOfWeek(java.util.Calendar calendar)
calendar
- the calendar to check.
public static boolean isEndOfWeek(java.util.Calendar calendar)
calendar
- the calendar to check.
public static void startOfWeek(java.util.Calendar calendar)
calendar
- the calendar to adjust.public static void endOfWeek(java.util.Calendar calendar)
calendar
- the calendar to adjust.public static java.util.Date endOfWeek(java.util.Calendar calendar, java.util.Date date)
calendar
- calendar to adjust.date
- the Date to use.
public static java.util.Date startOfWeek(java.util.Calendar calendar, java.util.Date date)
calendar
- calendar to adjust.date
- the Date to use.
public static void startOfDecade(java.util.Calendar calendar)
calendar
- the calendar to adjust.public static java.util.Date startOfDecade(java.util.Calendar calendar, java.util.Date date)
calendar
- date
- public static boolean isStartOfDecade(java.util.Calendar calendar)
calendar
- the calendar to check.
public static void startOfYear(java.util.Calendar calendar)
calendar
- the calendar to adjust.public static java.util.Date startOfYear(java.util.Calendar calendar, java.util.Date date)
calendar
- date
- public static boolean isStartOfYear(java.util.Calendar calendar)
calendar
- the calendar to check.
public static void startOfMonth(java.util.Calendar calendar)
calendar
- public static void endOfMonth(java.util.Calendar calendar)
calendar
- public static java.util.Date startOfDay(java.util.Calendar calendar, java.util.Date date)
calendar
- calendar to adjust.date
- the Date to use.
public static java.util.Date endOfDay(java.util.Calendar calendar, java.util.Date date)
calendar
- calendar to adjust.date
- the Date to use.
public static void startOfDay(java.util.Calendar calendar)
calendar
- calendar to adjust.public static void endOfDay(java.util.Calendar calendar)
calendar
- calendar to adjust.public static void startOf(java.util.Calendar calendar, int field)
calendar
- field
- the period to adjust, allowed are Calendar.DAY_OF_MONTH, -.MONTH,
-.WEEK and YEAR and CalendarUtils.DECADE.public static boolean isStartOf(java.util.Calendar calendar, int field)
calendar
- field
- the period to adjust, allowed are Calendar.DAY_OF_MONTH, -.MONTH,
-.WEEK and YEAR and CalendarUtils.DECADE.
java.lang.IllegalArgumentException
- if the field is not supported.public static boolean areEqual(java.util.Date current, java.util.Date date)
current
- one of the dates to comparedate
- the otherr of the dates to compare
public static boolean isSameDay(java.util.Calendar today, java.util.Date now)
today
- the Calendar representing a date, must not be null.now
- the date to compare to, must not be null
public static boolean isSame(java.util.Calendar today, java.util.Date now, int field)
today
- the Calendar representing a date, must not be null.now
- the date to compare to, must not be null
public static boolean isFlushed(java.util.Calendar calendar)
The only way to guarantee a flushed state is to let client code call getTime or getTimeInMillis. See Despairing in Calendar
Note: this if for testing only and not entirely safe!
calendar
-
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |