org.apache.commons.lang.time
public class DateUtils extends Object
A suite of utilities surrounding the use of the java.util.Calendar and java.util.Date object.
DateUtils contains a lot of common methods considering manipulations of Dates or Calendars. Some methods require some extra explanation. The truncate and round methods could be considered the Math.floor(), Math.ceil() or Math.round versions for dates This way date-fields will be ignored in bottom-up order. As a complement to these methods we've introduced some fragment-methods. With these methods the Date-fields will be ignored in top-down order. Since a date without a year is not a valid date, you have to decide in what kind of date-field you want your result, for instance milliseconds or days.
Since: 2.0
Version: $Id: DateUtils.java 634096 2008-03-06 00:58:11Z niallp $
Field Summary | |
---|---|
static int | MILLIS_IN_DAY
Number of milliseconds in a standard day.
|
static int | MILLIS_IN_HOUR
Number of milliseconds in a standard hour.
|
static int | MILLIS_IN_MINUTE
Number of milliseconds in a standard minute.
|
static int | MILLIS_IN_SECOND
Number of milliseconds in a standard second.
|
static long | MILLIS_PER_DAY
Number of milliseconds in a standard day. |
static long | MILLIS_PER_HOUR
Number of milliseconds in a standard hour. |
static long | MILLIS_PER_MINUTE
Number of milliseconds in a standard minute. |
static long | MILLIS_PER_SECOND
Number of milliseconds in a standard second. |
static int | RANGE_MONTH_MONDAY
A month range, the week starting on Monday. |
static int | RANGE_MONTH_SUNDAY
A month range, the week starting on Sunday. |
static int | RANGE_WEEK_CENTER
A week range, centered around the day focused. |
static int | RANGE_WEEK_MONDAY
A week range, starting on Monday. |
static int | RANGE_WEEK_RELATIVE
A week range, starting on the day focused. |
static int | RANGE_WEEK_SUNDAY
A week range, starting on Sunday. |
static int | SEMI_MONTH
This is half a month, so this represents whether a date is in the top
or bottom half of the month. |
static TimeZone | UTC_TIME_ZONE
The UTC time zone (often referred to as GMT). |
Constructor Summary | |
---|---|
DateUtils()
|
Method Summary | |
---|---|
static Date | add(Date date, int calendarField, int amount)
Adds to a date returning a new object.
|
static Date | addDays(Date date, int amount)
Adds a number of days to a date returning a new object.
|
static Date | addHours(Date date, int amount)
Adds a number of hours to a date returning a new object.
|
static Date | addMilliseconds(Date date, int amount)
Adds a number of milliseconds to a date returning a new object.
|
static Date | addMinutes(Date date, int amount)
Adds a number of minutes to a date returning a new object.
|
static Date | addMonths(Date date, int amount)
Adds a number of months to a date returning a new object.
|
static Date | addSeconds(Date date, int amount)
Adds a number of seconds to a date returning a new object.
|
static Date | addWeeks(Date date, int amount)
Adds a number of weeks to a date returning a new object.
|
static Date | addYears(Date date, int amount)
Adds a number of years to a date returning a new object.
|
static long | getFragmentInDays(Date date, int fragment) Returns the number of days within the fragment. |
static long | getFragmentInDays(Calendar calendar, int fragment) Returns the number of days within the fragment. |
static long | getFragmentInHours(Date date, int fragment) Returns the number of hours within the fragment. |
static long | getFragmentInHours(Calendar calendar, int fragment) Returns the number of hours within the fragment. |
static long | getFragmentInMilliseconds(Date date, int fragment) Returns the number of milliseconds within the fragment. |
static long | getFragmentInMilliseconds(Calendar calendar, int fragment) Returns the number of milliseconds within the fragment. |
static long | getFragmentInMinutes(Date date, int fragment) Returns the number of minutes within the fragment. |
static long | getFragmentInMinutes(Calendar calendar, int fragment) Returns the number of minutes within the fragment. |
static long | getFragmentInSeconds(Date date, int fragment) Returns the number of seconds within the fragment. |
static long | getFragmentInSeconds(Calendar calendar, int fragment) Returns the number of seconds within the fragment. |
static boolean | isSameDay(Date date1, Date date2) Checks if two date objects are on the same day ignoring time. 28 Mar 2002 13:45 and 28 Mar 2002 06:01 would return true. |
static boolean | isSameDay(Calendar cal1, Calendar cal2) Checks if two calendar objects are on the same day ignoring time. 28 Mar 2002 13:45 and 28 Mar 2002 06:01 would return true. |
static boolean | isSameInstant(Date date1, Date date2) Checks if two date objects represent the same instant in time. This method compares the long millisecond time of the two objects. |
static boolean | isSameInstant(Calendar cal1, Calendar cal2) Checks if two calendar objects represent the same instant in time. This method compares the long millisecond time of the two objects. |
static boolean | isSameLocalTime(Calendar cal1, Calendar cal2) Checks if two calendar objects represent the same local time. This method compares the values of the fields of the two objects. |
static Iterator | iterator(Date focus, int rangeStyle) This constructs an For instance, passing Thursday, July 4, 2002 and a
This method provides an iterator that returns Calendar objects. |
static Iterator | iterator(Calendar focus, int rangeStyle) This constructs an For instance, passing Thursday, July 4, 2002 and a
This method provides an iterator that returns Calendar objects. |
static Iterator | iterator(Object focus, int rangeStyle) This constructs an For instance, passing Thursday, July 4, 2002 and a
|
static Date | parseDate(String str, String[] parsePatterns) Parses a string representing a date by trying a variety of different parsers. The parse will try each parse pattern in turn. |
static Date | round(Date date, int field) Round this date, leaving the field specified as the most significant field. For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if this was passed with HOUR, it would return 28 Mar 2002 14:00:00.000. |
static Calendar | round(Calendar date, int field) Round this date, leaving the field specified as the most significant field. For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if this was passed with HOUR, it would return 28 Mar 2002 14:00:00.000. |
static Date | round(Object date, int field) Round this date, leaving the field specified as the most significant field. For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if this was passed with HOUR, it would return 28 Mar 2002 14:00:00.000. |
static Date | setDays(Date date, int amount)
Sets the day of month field to a date returning a new object.
|
static Date | setHours(Date date, int amount)
Sets the hours field to a date returning a new object. |
static Date | setMilliseconds(Date date, int amount)
Sets the miliseconds field to a date returning a new object.
|
static Date | setMinutes(Date date, int amount)
Sets the minute field to a date returning a new object.
|
static Date | setMonths(Date date, int amount)
Sets the months field to a date returning a new object.
|
static Date | setSeconds(Date date, int amount)
Sets the seconds field to a date returning a new object.
|
static Date | setYears(Date date, int amount)
Sets the years field to a date returning a new object.
|
static Date | truncate(Date date, int field) Truncate this date, leaving the field specified as the most significant field. For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if you passed with HOUR, it would return 28 Mar 2002 13:00:00.000. |
static Calendar | truncate(Calendar date, int field) Truncate this date, leaving the field specified as the most significant field. For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if you passed with HOUR, it would return 28 Mar 2002 13:00:00.000. |
static Date | truncate(Object date, int field) Truncate this date, leaving the field specified as the most significant field. For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if you passed with HOUR, it would return 28 Mar 2002 13:00:00.000. |
Deprecated: Use MILLIS_PER_DAY. This will be removed in Commons Lang 3.0.
Number of milliseconds in a standard day.Deprecated: Use MILLIS_PER_HOUR. This will be removed in Commons Lang 3.0.
Number of milliseconds in a standard hour.Deprecated: Use MILLIS_PER_MINUTE. This will be removed in Commons Lang 3.0.
Number of milliseconds in a standard minute.Deprecated: Use MILLIS_PER_SECOND. This will be removed in Commons Lang 3.0.
Number of milliseconds in a standard second.Since: 2.1
Since: 2.1
Since: 2.1
Since: 2.1
DateUtils
instances should NOT be constructed in
standard programming. Instead, the class should be used as
DateUtils.parse(str);
.
This constructor is public to permit tools that require a JavaBean instance to operate.
Deprecated: Will become privately scoped in 3.0
Adds to a date returning a new object. The original date object is unchanged.Parameters: date the date, not null calendarField the calendar field to add to amount the amount to add, may be negative
Returns: the new date object with the amount added
Throws: IllegalArgumentException if the date is null
Parameters: date the date, not null amount the amount to add, may be negative
Returns: the new date object with the amount added
Throws: IllegalArgumentException if the date is null
Parameters: date the date, not null amount the amount to add, may be negative
Returns: the new date object with the amount added
Throws: IllegalArgumentException if the date is null
Parameters: date the date, not null amount the amount to add, may be negative
Returns: the new date object with the amount added
Throws: IllegalArgumentException if the date is null
Parameters: date the date, not null amount the amount to add, may be negative
Returns: the new date object with the amount added
Throws: IllegalArgumentException if the date is null
Parameters: date the date, not null amount the amount to add, may be negative
Returns: the new date object with the amount added
Throws: IllegalArgumentException if the date is null
Parameters: date the date, not null amount the amount to add, may be negative
Returns: the new date object with the amount added
Throws: IllegalArgumentException if the date is null
Parameters: date the date, not null amount the amount to add, may be negative
Returns: the new date object with the amount added
Throws: IllegalArgumentException if the date is null
Parameters: date the date, not null amount the amount to add, may be negative
Returns: the new date object with the amount added
Throws: IllegalArgumentException if the date is null
Returns the number of days within the fragment. All datefields greater than the fragment will be ignored.
Asking the days of any date will only return the number of days of the current month (resulting in a number between 1 and 31). This method will retrieve the number of days for any fragment. For example, if you want to calculate the number of days past this year, your fragment is Calendar.YEAR. The result will be all days of the past month(s).
Valid fragments are: Calendar.YEAR, Calendar.MONTH, both Calendar.DAY_OF_YEAR and Calendar.DATE, Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND A fragment less than or equal to a DAY field will return 0.
Parameters: date the date to work with, not null fragment the Calendar field part of date to calculate
Returns: number of days within the fragment of date
Throws: IllegalArgumentException if the date is null
or
fragment is not supported
Since: 2.4
Returns the number of days within the fragment. All datefields greater than the fragment will be ignored.
Asking the days of any date will only return the number of days of the current month (resulting in a number between 1 and 31). This method will retrieve the number of days for any fragment. For example, if you want to calculate the number of days past this year, your fragment is Calendar.YEAR. The result will be all days of the past month(s).
Valid fragments are: Calendar.YEAR, Calendar.MONTH, both Calendar.DAY_OF_YEAR and Calendar.DATE, Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND A fragment less than or equal to a DAY field will return 0.
Parameters: calendar the calendar to work with, not null fragment the Calendar field part of calendar to calculate
Returns: number of days within the fragment of date
Throws: IllegalArgumentException if the date is null
or
fragment is not supported
Since: 2.4
Returns the number of hours within the fragment. All datefields greater than the fragment will be ignored.
Asking the hours of any date will only return the number of hours of the current day (resulting in a number between 0 and 23). This method will retrieve the number of hours for any fragment. For example, if you want to calculate the number of hours past this month, your fragment is Calendar.MONTH. The result will be all hours of the past day(s).
Valid fragments are: Calendar.YEAR, Calendar.MONTH, both Calendar.DAY_OF_YEAR and Calendar.DATE, Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND A fragment less than or equal to a HOUR field will return 0.
Parameters: date the date to work with, not null fragment the Calendar field part of date to calculate
Returns: number of hours within the fragment of date
Throws: IllegalArgumentException if the date is null
or
fragment is not supported
Since: 2.4
Returns the number of hours within the fragment. All datefields greater than the fragment will be ignored.
Asking the hours of any date will only return the number of hours of the current day (resulting in a number between 0 and 23). This method will retrieve the number of hours for any fragment. For example, if you want to calculate the number of hours past this month, your fragment is Calendar.MONTH. The result will be all hours of the past day(s).
Valid fragments are: Calendar.YEAR, Calendar.MONTH, both Calendar.DAY_OF_YEAR and Calendar.DATE, Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND A fragment less than or equal to a HOUR field will return 0.
Parameters: calendar the calendar to work with, not null fragment the Calendar field part of calendar to calculate
Returns: number of hours within the fragment of date
Throws: IllegalArgumentException if the date is null
or
fragment is not supported
Since: 2.4
Returns the number of milliseconds within the fragment. All datefields greater than the fragment will be ignored.
Asking the milliseconds of any date will only return the number of milliseconds of the current second (resulting in a number between 0 and 999). This method will retrieve the number of milliseconds for any fragment. For example, if you want to calculate the number of milliseconds past today, your fragment is Calendar.DATE or Calendar.DAY_OF_YEAR. The result will be all milliseconds of the past hour(s), minutes(s) and second(s).
Valid fragments are: Calendar.YEAR, Calendar.MONTH, both Calendar.DAY_OF_YEAR and Calendar.DATE, Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND A fragment less than or equal to a SECOND field will return 0.
Parameters: date the date to work with, not null fragment the Calendar field part of date to calculate
Returns: number of milliseconds within the fragment of date
Throws: IllegalArgumentException if the date is null
or
fragment is not supported
Since: 2.4
Returns the number of milliseconds within the fragment. All datefields greater than the fragment will be ignored.
Asking the milliseconds of any date will only return the number of milliseconds of the current second (resulting in a number between 0 and 999). This method will retrieve the number of milliseconds for any fragment. For example, if you want to calculate the number of seconds past today, your fragment is Calendar.DATE or Calendar.DAY_OF_YEAR. The result will be all seconds of the past hour(s), minutes(s) and second(s).
Valid fragments are: Calendar.YEAR, Calendar.MONTH, both Calendar.DAY_OF_YEAR and Calendar.DATE, Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND A fragment less than or equal to a MILLISECOND field will return 0.
Parameters: calendar the calendar to work with, not null fragment the Calendar field part of calendar to calculate
Returns: number of milliseconds within the fragment of date
Throws: IllegalArgumentException if the date is null
or
fragment is not supported
Since: 2.4
Returns the number of minutes within the fragment. All datefields greater than the fragment will be ignored.
Asking the minutes of any date will only return the number of minutes of the current hour (resulting in a number between 0 and 59). This method will retrieve the number of minutes for any fragment. For example, if you want to calculate the number of minutes past this month, your fragment is Calendar.MONTH. The result will be all minutes of the past day(s) and hour(s).
Valid fragments are: Calendar.YEAR, Calendar.MONTH, both Calendar.DAY_OF_YEAR and Calendar.DATE, Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND A fragment less than or equal to a MINUTE field will return 0.
Parameters: date the date to work with, not null fragment the Calendar field part of date to calculate
Returns: number of minutes within the fragment of date
Throws: IllegalArgumentException if the date is null
or
fragment is not supported
Since: 2.4
Returns the number of minutes within the fragment. All datefields greater than the fragment will be ignored.
Asking the minutes of any date will only return the number of minutes of the current hour (resulting in a number between 0 and 59). This method will retrieve the number of minutes for any fragment. For example, if you want to calculate the number of minutes past this month, your fragment is Calendar.MONTH. The result will be all minutes of the past day(s) and hour(s).
Valid fragments are: Calendar.YEAR, Calendar.MONTH, both Calendar.DAY_OF_YEAR and Calendar.DATE, Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND A fragment less than or equal to a MINUTE field will return 0.
Parameters: calendar the calendar to work with, not null fragment the Calendar field part of calendar to calculate
Returns: number of minutes within the fragment of date
Throws: IllegalArgumentException if the date is null
or
fragment is not supported
Since: 2.4
Returns the number of seconds within the fragment. All datefields greater than the fragment will be ignored.
Asking the seconds of any date will only return the number of seconds of the current minute (resulting in a number between 0 and 59). This method will retrieve the number of seconds for any fragment. For example, if you want to calculate the number of seconds past today, your fragment is Calendar.DATE or Calendar.DAY_OF_YEAR. The result will be all seconds of the past hour(s) and minutes(s).
Valid fragments are: Calendar.YEAR, Calendar.MONTH, both Calendar.DAY_OF_YEAR and Calendar.DATE, Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND A fragment less than or equal to a SECOND field will return 0.
Parameters: date the date to work with, not null fragment the Calendar field part of date to calculate
Returns: number of seconds within the fragment of date
Throws: IllegalArgumentException if the date is null
or
fragment is not supported
Since: 2.4
Returns the number of seconds within the fragment. All datefields greater than the fragment will be ignored.
Asking the seconds of any date will only return the number of seconds of the current minute (resulting in a number between 0 and 59). This method will retrieve the number of seconds for any fragment. For example, if you want to calculate the number of seconds past today, your fragment is Calendar.DATE or Calendar.DAY_OF_YEAR. The result will be all seconds of the past hour(s) and minutes(s).
Valid fragments are: Calendar.YEAR, Calendar.MONTH, both Calendar.DAY_OF_YEAR and Calendar.DATE, Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND A fragment less than or equal to a SECOND field will return 0.
Parameters: calendar the calendar to work with, not null fragment the Calendar field part of calendar to calculate
Returns: number of seconds within the fragment of date
Throws: IllegalArgumentException if the date is null
or
fragment is not supported
Since: 2.4
Checks if two date objects are on the same day ignoring time.
28 Mar 2002 13:45 and 28 Mar 2002 06:01 would return true. 28 Mar 2002 13:45 and 12 Mar 2002 13:45 would return false.
Parameters: date1 the first date, not altered, not null date2 the second date, not altered, not null
Returns: true if they represent the same day
Throws: IllegalArgumentException if either date is null
Since: 2.1
Checks if two calendar objects are on the same day ignoring time.
28 Mar 2002 13:45 and 28 Mar 2002 06:01 would return true. 28 Mar 2002 13:45 and 12 Mar 2002 13:45 would return false.
Parameters: cal1 the first calendar, not altered, not null cal2 the second calendar, not altered, not null
Returns: true if they represent the same day
Throws: IllegalArgumentException if either calendar is null
Since: 2.1
Checks if two date objects represent the same instant in time.
This method compares the long millisecond time of the two objects.
Parameters: date1 the first date, not altered, not null date2 the second date, not altered, not null
Returns: true if they represent the same millisecond instant
Throws: IllegalArgumentException if either date is null
Since: 2.1
Checks if two calendar objects represent the same instant in time.
This method compares the long millisecond time of the two objects.
Parameters: cal1 the first calendar, not altered, not null cal2 the second calendar, not altered, not null
Returns: true if they represent the same millisecond instant
Throws: IllegalArgumentException if either date is null
Since: 2.1
Checks if two calendar objects represent the same local time.
This method compares the values of the fields of the two objects. In addition, both calendars must be the same of the same type.
Parameters: cal1 the first calendar, not altered, not null cal2 the second calendar, not altered, not null
Returns: true if they represent the same millisecond instant
Throws: IllegalArgumentException if either date is null
Since: 2.1
This constructs an Iterator
over each day in a date
range defined by a focus date and range style.
For instance, passing Thursday, July 4, 2002 and a
RANGE_MONTH_SUNDAY
will return an Iterator
that starts with Sunday, June 30, 2002 and ends with Saturday, August 3,
2002, returning a Calendar instance for each intermediate day.
This method provides an iterator that returns Calendar objects. The days are progressed using Calendar#add(int, int).
Parameters: focus the date to work with, not null rangeStyle the style constant to use. Must be one of RANGE_MONTH_SUNDAY, RANGE_MONTH_MONDAY, RANGE_WEEK_SUNDAY, RANGE_WEEK_MONDAY, RANGE_WEEK_RELATIVE, RANGE_WEEK_CENTER
Returns: the date iterator, which always returns Calendar instances
Throws: IllegalArgumentException if the date is null
IllegalArgumentException if the rangeStyle is invalid
This constructs an Iterator
over each day in a date
range defined by a focus date and range style.
For instance, passing Thursday, July 4, 2002 and a
RANGE_MONTH_SUNDAY
will return an Iterator
that starts with Sunday, June 30, 2002 and ends with Saturday, August 3,
2002, returning a Calendar instance for each intermediate day.
This method provides an iterator that returns Calendar objects. The days are progressed using Calendar#add(int, int).
Parameters: focus the date to work with rangeStyle the style constant to use. Must be one of RANGE_MONTH_SUNDAY, RANGE_MONTH_MONDAY, RANGE_WEEK_SUNDAY, RANGE_WEEK_MONDAY, RANGE_WEEK_RELATIVE, RANGE_WEEK_CENTER
Returns: the date iterator
Throws: IllegalArgumentException if the date is null
IllegalArgumentException if the rangeStyle is invalid
This constructs an Iterator
over each day in a date
range defined by a focus date and range style.
For instance, passing Thursday, July 4, 2002 and a
RANGE_MONTH_SUNDAY
will return an Iterator
that starts with Sunday, June 30, 2002 and ends with Saturday, August 3,
2002, returning a Calendar instance for each intermediate day.
Parameters: focus the date to work with, either
Date
or Calendar
rangeStyle the style constant to use. Must be one of the range
styles listed for the DateUtils method.
Returns: the date iterator
Throws: IllegalArgumentException if the date
is null
ClassCastException if the object type is
not a Date
or Calendar
Parses a string representing a date by trying a variety of different parsers.
The parse will try each parse pattern in turn. A parse is only deemed sucessful if it parses the whole of the input string. If no parse patterns match, a ParseException is thrown.
Parameters: str the date to parse, not null parsePatterns the date format patterns to use, see SimpleDateFormat, not null
Returns: the parsed date
Throws: IllegalArgumentException if the date string or pattern array is null ParseException if none of the date patterns were suitable
Round this date, leaving the field specified as the most significant field.
For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if this was passed with HOUR, it would return 28 Mar 2002 14:00:00.000. If this was passed with MONTH, it would return 1 April 2002 0:00:00.000.
For a date in a timezone that handles the change to daylight saving time, rounding to Calendar.HOUR_OF_DAY will behave as follows. Suppose daylight saving time begins at 02:00 on March 30. Rounding a date that crosses this time would produce the following values:
Parameters: date the date to work with field the field from Calendar
or SEMI_MONTH
Returns: the rounded date
Throws: IllegalArgumentException if the date is null
ArithmeticException if the year is over 280 million
Round this date, leaving the field specified as the most significant field.
For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if this was passed with HOUR, it would return 28 Mar 2002 14:00:00.000. If this was passed with MONTH, it would return 1 April 2002 0:00:00.000.
For a date in a timezone that handles the change to daylight saving time, rounding to Calendar.HOUR_OF_DAY will behave as follows. Suppose daylight saving time begins at 02:00 on March 30. Rounding a date that crosses this time would produce the following values:
Parameters: date the date to work with field the field from Calendar
or SEMI_MONTH
Returns: the rounded date (a different object)
Throws: IllegalArgumentException if the date is null
ArithmeticException if the year is over 280 million
Round this date, leaving the field specified as the most significant field.
For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if this was passed with HOUR, it would return 28 Mar 2002 14:00:00.000. If this was passed with MONTH, it would return 1 April 2002 0:00:00.000.
For a date in a timezone that handles the change to daylight saving time, rounding to Calendar.HOUR_OF_DAY will behave as follows. Suppose daylight saving time begins at 02:00 on March 30. Rounding a date that crosses this time would produce the following values:
Parameters: date the date to work with, either Date or Calendar field the field from Calendar
or SEMI_MONTH
Returns: the rounded date
Throws: IllegalArgumentException if the date is null
ClassCastException if the object type is not a Date
or Calendar
ArithmeticException if the year is over 280 million
Parameters: date the date, not null amount the amount to set
Returns: a new Date object set with the specified value
Throws: IllegalArgumentException if the date is null
Since: 2.4
Parameters: date the date, not null amount the amount to set
Returns: a new Date object set with the specified value
Throws: IllegalArgumentException if the date is null
Since: 2.4
Parameters: date the date, not null amount the amount to set
Returns: a new Date object set with the specified value
Throws: IllegalArgumentException if the date is null
Since: 2.4
Parameters: date the date, not null amount the amount to set
Returns: a new Date object set with the specified value
Throws: IllegalArgumentException if the date is null
Since: 2.4
Parameters: date the date, not null amount the amount to set
Returns: a new Date object set with the specified value
Throws: IllegalArgumentException if the date is null
Since: 2.4
Parameters: date the date, not null amount the amount to set
Returns: a new Date object set with the specified value
Throws: IllegalArgumentException if the date is null
Since: 2.4
Parameters: date the date, not null amount the amount to set
Returns: a new Date object set with the specified value
Throws: IllegalArgumentException if the date is null
Since: 2.4
Truncate this date, leaving the field specified as the most significant field.
For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if you passed with HOUR, it would return 28 Mar 2002 13:00:00.000. If this was passed with MONTH, it would return 1 Mar 2002 0:00:00.000.
Parameters: date the date to work with field the field from Calendar
or SEMI_MONTH
Returns: the rounded date
Throws: IllegalArgumentException if the date is null
ArithmeticException if the year is over 280 million
Truncate this date, leaving the field specified as the most significant field.
For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if you passed with HOUR, it would return 28 Mar 2002 13:00:00.000. If this was passed with MONTH, it would return 1 Mar 2002 0:00:00.000.
Parameters: date the date to work with field the field from Calendar
or SEMI_MONTH
Returns: the rounded date (a different object)
Throws: IllegalArgumentException if the date is null
ArithmeticException if the year is over 280 million
Truncate this date, leaving the field specified as the most significant field.
For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if you passed with HOUR, it would return 28 Mar 2002 13:00:00.000. If this was passed with MONTH, it would return 1 Mar 2002 0:00:00.000.
Parameters: date the date to work with, either Date
or Calendar
field the field from Calendar
or SEMI_MONTH
Returns: the rounded date
Throws: IllegalArgumentException if the date
is null
ClassCastException if the object type is not a
Date
or Calendar
ArithmeticException if the year is over 280 million