DateUtil (abacus-util 1.21.7 API)

java.lang.Object
- com.landawn.abacus.util.DateUtil

Direct Known Subclasses:

DateUtil.DateTimeUtil
```
public abstract class DateUtil
extends Object
```
Since:

1.2.6

Author:

Haiyang Li

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class DateUtil.DateTimeUtil
The Class DateTimeUtil.

Nested Classes
Modifier and Type	Class and Description
`static class`	`DateUtil.DateTimeUtil` The Class DateTimeUtil.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ISO_8601_DATETIME_FORMAT` It's default date/time format.
`static String`	`ISO_8601_TIMESTAMP_FORMAT` It's default timestamp format.
`static String`	`LOCAL_DATE_FORMAT`
`static String`	`LOCAL_DATETIME_FORMAT`
`static String`	`LOCAL_MONTH_DAY_FORMAT`
`static String`	`LOCAL_TIME_FORMAT`
`static TimeZone`	`LOCAL_TIME_ZONE`
`static String`	`LOCAL_TIMESTAMP_FORMAT`
`static String`	`LOCAL_YEAR_FORMAT` Date format.
`static String`	`RFC1123_DATE_FORMAT` This constant defines the date format specified by RFC 1123 / RFC 822.
`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`

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static <T extends Calendar> T`	`addDays(T calendar, int amount)` Adds a number of days to a calendar returning a new object.
`static <T extends Date> T`	`addDays(T date, int amount)` Adds a number of days to a date returning a new object.
`static <T extends Calendar> T`	`addHours(T calendar, int amount)` Adds a number of hours to a calendar returning a new object.
`static <T extends Date> T`	`addHours(T date, int amount)` Adds a number of hours to a date returning a new object.
`static <T extends Calendar> T`	`addMilliseconds(T calendar, int amount)` Adds a number of milliseconds to a calendar returning a new object.
`static <T extends Date> T`	`addMilliseconds(T date, int amount)` Adds a number of milliseconds to a date returning a new object.
`static <T extends Calendar> T`	`addMinutes(T calendar, int amount)` Adds a number of minutes to a calendar returning a new object.
`static <T extends Date> T`	`addMinutes(T date, int amount)` Adds a number of minutes to a date returning a new object.
`static <T extends Calendar> T`	`addMonths(T calendar, int amount)` Adds a number of months to a calendar returning a new object.
`static <T extends Date> T`	`addMonths(T date, int amount)` Adds a number of months to a date returning a new object.
`static <T extends Calendar> T`	`addSeconds(T calendar, int amount)` Adds a number of seconds to a calendar returning a new object.
`static <T extends Date> T`	`addSeconds(T date, int amount)` Adds a number of seconds to a date returning a new object.
`static <T extends Calendar> T`	`addWeeks(T calendar, int amount)` Adds a number of weeks to a calendar returning a new object.
`static <T extends Date> T`	`addWeeks(T date, int amount)` Adds a number of weeks to a date returning a new object.
`static <T extends Calendar> T`	`addYears(T calendar, int amount)` Adds a number of years to a calendar returning a new object.
`static <T extends Date> T`	`addYears(T date, int amount)` Adds a number of years to a date returning a new object.
`static <T extends Calendar> T`	`ceiling(T calendar, int field)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Date> T`	`ceiling(T date, int field)` Copied from Apache Commons Lang under Apache License v2.
`static Calendar`	`createCalendar(Calendar calendar)` Creates the calendar.
`static Calendar`	`createCalendar(Date date)` Creates the calendar.
`static Calendar`	`createCalendar(long timeInMillis)` Creates the calendar.
`static Calendar`	`createCalendar(long timeInMillis, TimeZone tz)` Creates the calendar.
`static Date`	`createDate(Calendar calendar)` Creates the date.
`static Date`	`createDate(Date date)` Creates the date.
`static Date`	`createDate(long timeInMillis)` Creates the date.
`static GregorianCalendar`	`createGregorianCalendar(Calendar calendar)` Creates the gregorian calendar.
`static GregorianCalendar`	`createGregorianCalendar(Date date)` Creates the gregorian calendar.
`static GregorianCalendar`	`createGregorianCalendar(long timeInMillis)` Creates the gregorian calendar.
`static GregorianCalendar`	`createGregorianCalendar(long timeInMillis, TimeZone tz)` Creates the gregorian calendar.
`static Date`	`createJUDate(Calendar calendar)` Creates the JU date.
`static Date`	`createJUDate(Date date)` Creates the JU date.
`static Date`	`createJUDate(long timeInMillis)` Creates the JU date.
`static Time`	`createTime(Calendar calendar)` Creates the time.
`static Time`	`createTime(Date date)` Creates the time.
`static Time`	`createTime(long timeInMillis)` Creates the time.
`static Timestamp`	`createTimestamp(Calendar calendar)` Creates the timestamp.
`static Timestamp`	`createTimestamp(Date date)` Creates the timestamp.
`static Timestamp`	`createTimestamp(long timeInMillis)` Creates the timestamp.
`static XMLGregorianCalendar`	`createXMLGregorianCalendar(Calendar calendar)` Creates the XML gregorian calendar.
`static XMLGregorianCalendar`	`createXMLGregorianCalendar(Date date)` Creates the XML gregorian calendar.
`static XMLGregorianCalendar`	`createXMLGregorianCalendar(long timeInMillis)` Creates the XML gregorian calendar.
`static Calendar`	`currentCalendar()` A new instance of `java.util.Calendar` returned is based on the current time in the default time zone with the default locale.
`static Date`	`currentDate()` A new instance of `java.sql.Date` returned is based on the current time in the default time zone with the default locale.
`static GregorianCalendar`	`currentGregorianCalendar()` Current gregorian calendar.
`static Date`	`currentJUDate()` A new instance of `java.util.Date` returned is based on the current time in the default time zone with the default locale.
`static Time`	`currentTime()` A new instance of `java.sql.Time` returned is based on the current time in the default time zone with the default locale.
`static Timestamp`	`currentTimestamp()` A new instance of `java.sql.Timestamp` returned is based on the current time in the default time zone with the default locale.
`static XMLGregorianCalendar`	`currentXMLGregorianCalendar()` Current XML gregorian calendar.
`static String`	`format(Calendar c)`
`static String`	`format(Calendar c, String format)`
`static String`	`format(Calendar c, String format, TimeZone timeZone)`
`static String`	`format(Date date)`
`static String`	`format(Date date, String format)`
`static String`	`format(Date date, String format, TimeZone timeZone)`
`static void`	`format(Writer writer, Calendar c)`
`static void`	`format(Writer writer, Calendar c, String format)`
`static void`	`format(Writer writer, Calendar c, String format, TimeZone timeZone)`
`static void`	`format(Writer writer, Date date)`
`static void`	`format(Writer writer, Date date, String format)`
`static void`	`format(Writer writer, Date date, String format, TimeZone timeZone)`
`static void`	`format(Writer writer, XMLGregorianCalendar c)`
`static void`	`format(Writer writer, XMLGregorianCalendar c, String format)`
`static void`	`format(Writer writer, XMLGregorianCalendar c, String format, TimeZone timeZone)`
`static String`	`format(XMLGregorianCalendar c)`
`static String`	`format(XMLGregorianCalendar c, String format)`
`static String`	`format(XMLGregorianCalendar c, String format, TimeZone timeZone)`
`static Calendar`	`parseCalendar(String calendar)` Parses the calendar.
`static Calendar`	`parseCalendar(String calendar, String format)` Parses the calendar.
`static Calendar`	`parseCalendar(String calendar, String format, TimeZone timeZone)` Converts the specified `calendar` with the specified `format` to a new instance of Calendar.
`static Date`	`parseDate(String date)` Parses the date.
`static Date`	`parseDate(String date, String format)` Parses the date.
`static Date`	`parseDate(String date, String format, TimeZone timeZone)` Converts the specified `date` with the specified `format` to a new instance of java.sql.Date.
`static GregorianCalendar`	`parseGregorianCalendar(String calendar)` Parses the gregorian calendar.
`static GregorianCalendar`	`parseGregorianCalendar(String calendar, String format)` Parses the gregorian calendar.
`static GregorianCalendar`	`parseGregorianCalendar(String calendar, String format, TimeZone timeZone)` Converts the specified `calendar` with the specified `format` to a new instance of GregorianCalendar.
`static Date`	`parseJUDate(String date)` Parses the JU date.
`static Date`	`parseJUDate(String date, String format)` Parses the JU date.
`static Date`	`parseJUDate(String date, String format, TimeZone timeZone)` Converts the specified `date` with the specified `format` to a new instance of java.util.Date.
`static Time`	`parseTime(String date)` Parses the time.
`static Time`	`parseTime(String date, String format)` Parses the time.
`static Time`	`parseTime(String date, String format, TimeZone timeZone)` Converts the specified `date` with the specified `format` to a new instance of Time.
`static Timestamp`	`parseTimestamp(String date)` Parses the timestamp.
`static Timestamp`	`parseTimestamp(String date, String format)` Parses the timestamp.
`static Timestamp`	`parseTimestamp(String date, String format, TimeZone timeZone)` Converts the specified `date` with the specified `format` to a new instance of Timestamp.
`static XMLGregorianCalendar`	`parseXMLGregorianCalendar(String calendar)` Parses the XML gregorian calendar.
`static XMLGregorianCalendar`	`parseXMLGregorianCalendar(String calendar, String format)` Parses the XML gregorian calendar.
`static XMLGregorianCalendar`	`parseXMLGregorianCalendar(String calendar, String format, TimeZone timeZone)` Converts the specified `calendar` with the specified `format` to a new instance of XMLGregorianCalendar.
`static <T extends Calendar> T`	`roll(T calendar, long amount, CalendarUnit unit)` Deprecated. replaced by `addYears/addMonths/addWeeks/...`
`static <T extends Date> T`	`roll(T date, long amount, CalendarUnit unit)` Deprecated. replaced by `addYears/addMonths/addWeeks/...`
`static <T extends Calendar> T`	`roll(T calendar, long amount, TimeUnit unit)` Deprecated. replaced by `addYears/addMonths/addWeeks/...`
`static <T extends Date> T`	`roll(T date, long amount, TimeUnit unit)` Deprecated. replaced by `addYears/addMonths/addWeeks/...`
`static <T extends Calendar> T`	`round(T calendar, int field)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Date> T`	`round(T date, int field)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Date> T`	`setDays(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Date> T`	`setHours(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Date> T`	`setMilliseconds(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Date> T`	`setMinutes(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Date> T`	`setMonths(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Date> T`	`setSeconds(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Date> T`	`setYears(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Calendar> T`	`truncate(T calendar, int field)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends Date> T`	`truncate(T date, int field)` Copied from Apache Commons Lang under Apache License v2.
`static int`	`truncatedCompareTo(Calendar cal1, Calendar cal2, int field)` Copied from Apache Commons Lang under Apache License v2.
`static int`	`truncatedCompareTo(Date date1, Date date2, int field)` Copied from Apache Commons Lang under Apache License v2.
`static boolean`	`truncatedEquals(Calendar cal1, Calendar cal2, int field)` Copied from Apache Commons Lang under Apache License v2.
`static boolean`	`truncatedEquals(Date date1, Date date2, int field)` Copied from Apache Commons Lang under Apache License v2.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - UTC_TIME_ZONE
```
public static final TimeZone UTC_TIME_ZONE
```
  - LOCAL_TIME_ZONE
```
public static final TimeZone LOCAL_TIME_ZONE
```
  - LOCAL_YEAR_FORMAT
```
public static final String LOCAL_YEAR_FORMAT
```
    Date format.
    
    See Also:
    
    Constant Field Values
  - LOCAL_MONTH_DAY_FORMAT
```
public static final String LOCAL_MONTH_DAY_FORMAT
```
    See Also:
    
    Constant Field Values
  - LOCAL_DATE_FORMAT
```
public static final String LOCAL_DATE_FORMAT
```
    See Also:
    
    Constant Field Values
  - LOCAL_TIME_FORMAT
```
public static final String LOCAL_TIME_FORMAT
```
    See Also:
    
    Constant Field Values
  - LOCAL_DATETIME_FORMAT
```
public static final String LOCAL_DATETIME_FORMAT
```
    See Also:
    
    Constant Field Values
  - LOCAL_TIMESTAMP_FORMAT
```
public static final String LOCAL_TIMESTAMP_FORMAT
```
    See Also:
    
    Constant Field Values
  - ISO_8601_DATETIME_FORMAT
```
public static final String ISO_8601_DATETIME_FORMAT
```
    It's default date/time format.
    
    See Also:
    
    Constant Field Values
  - ISO_8601_TIMESTAMP_FORMAT
```
public static final String ISO_8601_TIMESTAMP_FORMAT
```
    It's default timestamp format.
    
    See Also:
    
    Constant Field Values
  - RFC1123_DATE_FORMAT
```
public static final String RFC1123_DATE_FORMAT
```
    This constant defines the date format specified by RFC 1123 / RFC 822. Used for parsing via `SimpleDateFormat` as well as error messages.
    
    See Also:
    
    Constant Field Values
  - SEMI_MONTH
```
public static final int SEMI_MONTH
```
    This is half a month, so this represents whether a date is in the top or bottom half of the month.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - currentTime
```
public static Time currentTime()
```
    A new instance of java.sql.Time returned is based on the current time in the default time zone with the default locale.
    
    Returns:
  - currentDate
```
public static Date currentDate()
```
    A new instance of java.sql.Date returned is based on the current time in the default time zone with the default locale.
    
    Returns:
  - currentTimestamp
```
public static Timestamp currentTimestamp()
```
    A new instance of java.sql.Timestamp returned is based on the current time in the default time zone with the default locale.
    
    Returns:
  - currentJUDate
```
public static Date currentJUDate()
```
    A new instance of java.util.Date returned is based on the current time in the default time zone with the default locale.
    
    Returns:
  - currentCalendar
```
public static Calendar currentCalendar()
```
    A new instance of java.util.Calendar returned is based on the current time in the default time zone with the default locale.
    
    Returns:
    
    a Calendar.
  - currentGregorianCalendar
```
public static GregorianCalendar currentGregorianCalendar()
```
    Current gregorian calendar.
    
    Returns:
  - currentXMLGregorianCalendar
```
public static XMLGregorianCalendar currentXMLGregorianCalendar()
```
    Current XML gregorian calendar.
    
    Returns:
  - createJUDate
```
public static Date createJUDate(Calendar calendar)
```
    Creates the JU date.
    
    Parameters:
    
    calendar -
    
    Returns:
  - createJUDate
```
public static Date createJUDate(Date date)
```
    Creates the JU date.
    
    Parameters:
    
    date -
    
    Returns:
  - createJUDate
```
public static Date createJUDate(long timeInMillis)
```
    Creates the JU date.
    
    Parameters:
    
    timeInMillis -
    
    Returns:
  - createDate
```
public static Date createDate(Calendar calendar)
```
    Creates the date.
    
    Parameters:
    
    calendar -
    
    Returns:
  - createDate
```
public static Date createDate(Date date)
```
    Creates the date.
    
    Parameters:
    
    date -
    
    Returns:
  - createDate
```
public static Date createDate(long timeInMillis)
```
    Creates the date.
    
    Parameters:
    
    timeInMillis -
    
    Returns:
  - createTime
```
public static Time createTime(Calendar calendar)
```
    Creates the time.
    
    Parameters:
    
    calendar -
    
    Returns:
  - createTime
```
public static Time createTime(Date date)
```
    Creates the time.
    
    Parameters:
    
    date -
    
    Returns:
  - createTime
```
public static Time createTime(long timeInMillis)
```
    Creates the time.
    
    Parameters:
    
    timeInMillis -
    
    Returns:
  - createTimestamp
```
public static Timestamp createTimestamp(Calendar calendar)
```
    Creates the timestamp.
    
    Parameters:
    
    calendar -
    
    Returns:
  - createTimestamp
```
public static Timestamp createTimestamp(Date date)
```
    Creates the timestamp.
    
    Parameters:
    
    date -
    
    Returns:
  - createTimestamp
```
public static Timestamp createTimestamp(long timeInMillis)
```
    Creates the timestamp.
    
    Parameters:
    
    timeInMillis -
    
    Returns:
  - createCalendar
```
public static Calendar createCalendar(Calendar calendar)
```
    Creates the calendar.
    
    Parameters:
    
    calendar -
    
    Returns:
  - createCalendar
```
public static Calendar createCalendar(Date date)
```
    Creates the calendar.
    
    Parameters:
    
    date -
    
    Returns:
  - createCalendar
```
public static Calendar createCalendar(long timeInMillis)
```
    Creates the calendar.
    
    Parameters:
    
    timeInMillis -
    
    Returns:
  - createCalendar
```
public static Calendar createCalendar(long timeInMillis,
                                      TimeZone tz)
```
    Creates the calendar.
    
    Parameters:
    
    timeInMillis -
    
    tz -
    
    Returns:
  - createGregorianCalendar
```
public static GregorianCalendar createGregorianCalendar(Calendar calendar)
```
    Creates the gregorian calendar.
    
    Parameters:
    
    calendar -
    
    Returns:
  - createGregorianCalendar
```
public static GregorianCalendar createGregorianCalendar(Date date)
```
    Creates the gregorian calendar.
    
    Parameters:
    
    date -
    
    Returns:
  - createGregorianCalendar
```
public static GregorianCalendar createGregorianCalendar(long timeInMillis)
```
    Creates the gregorian calendar.
    
    Parameters:
    
    timeInMillis -
    
    Returns:
  - createGregorianCalendar
```
public static GregorianCalendar createGregorianCalendar(long timeInMillis,
                                                        TimeZone tz)
```
    Creates the gregorian calendar.
    
    Parameters:
    
    timeInMillis -
    
    tz -
    
    Returns:
  - createXMLGregorianCalendar
```
public static XMLGregorianCalendar createXMLGregorianCalendar(Calendar calendar)
```
    Creates the XML gregorian calendar.
    
    Parameters:
    
    calendar -
    
    Returns:
  - createXMLGregorianCalendar
```
public static XMLGregorianCalendar createXMLGregorianCalendar(Date date)
```
    Creates the XML gregorian calendar.
    
    Parameters:
    
    date -
    
    Returns:
  - createXMLGregorianCalendar
```
public static XMLGregorianCalendar createXMLGregorianCalendar(long timeInMillis)
```
    Creates the XML gregorian calendar.
    
    Parameters:
    
    timeInMillis -
    
    Returns:
  - parseJUDate
```
public static Date parseJUDate(String date)
```
    Parses the JU date.
    
    Parameters:
    
    date -
    
    Returns:
  - parseJUDate
```
public static Date parseJUDate(String date,
                               String format)
```
    Parses the JU date.
    
    Parameters:
    
    date -
    
    format -
    
    Returns:
  - parseJUDate
```
public static Date parseJUDate(String date,
                               String format,
                               TimeZone timeZone)
```
    Converts the specified date with the specified format to a new instance of java.util.Date. null is returned if the specified date is null or empty.
    
    Parameters:
    
    date -
    
    format -
    
    timeZone -
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date given can't be parsed with specified format.
  - parseDate
```
public static Date parseDate(String date)
```
    Parses the date.
    
    Parameters:
    
    date -
    
    Returns:
  - parseDate
```
public static Date parseDate(String date,
                             String format)
```
    Parses the date.
    
    Parameters:
    
    date -
    
    format -
    
    Returns:
  - parseDate
```
public static Date parseDate(String date,
                             String format,
                             TimeZone timeZone)
```
    Converts the specified date with the specified format to a new instance of java.sql.Date. null is returned if the specified date is null or empty.
    
    Parameters:
    
    date -
    
    format -
    
    timeZone -
    
    Returns:
  - parseTime
```
public static Time parseTime(String date)
```
    Parses the time.
    
    Parameters:
    
    date -
    
    Returns:
  - parseTime
```
public static Time parseTime(String date,
                             String format)
```
    Parses the time.
    
    Parameters:
    
    date -
    
    format -
    
    Returns:
  - parseTime
```
public static Time parseTime(String date,
                             String format,
                             TimeZone timeZone)
```
    Converts the specified date with the specified format to a new instance of Time. null is returned if the specified date is null or empty.
    
    Parameters:
    
    date -
    
    format -
    
    timeZone -
    
    Returns:
  - parseTimestamp
```
public static Timestamp parseTimestamp(String date)
```
    Parses the timestamp.
    
    Parameters:
    
    date -
    
    Returns:
  - parseTimestamp
```
public static Timestamp parseTimestamp(String date,
                                       String format)
```
    Parses the timestamp.
    
    Parameters:
    
    date -
    
    format -
    
    Returns:
  - parseTimestamp
```
public static Timestamp parseTimestamp(String date,
                                       String format,
                                       TimeZone timeZone)
```
    Converts the specified date with the specified format to a new instance of Timestamp. null is returned if the specified date is null or empty.
    
    Parameters:
    
    date -
    
    format -
    
    timeZone -
    
    Returns:
  - parseCalendar
```
public static Calendar parseCalendar(String calendar)
```
    Parses the calendar.
    
    Parameters:
    
    calendar -
    
    Returns:
  - parseCalendar
```
public static Calendar parseCalendar(String calendar,
                                     String format)
```
    Parses the calendar.
    
    Parameters:
    
    calendar -
    
    format -
    
    Returns:
  - parseCalendar
```
public static Calendar parseCalendar(String calendar,
                                     String format,
                                     TimeZone timeZone)
```
    Converts the specified calendar with the specified format to a new instance of Calendar. null is returned if the specified date is null or empty.
    
    Parameters:
    
    calendar -
    
    format -
    
    timeZone -
    
    Returns:
  - parseGregorianCalendar
```
public static GregorianCalendar parseGregorianCalendar(String calendar)
```
    Parses the gregorian calendar.
    
    Parameters:
    
    calendar -
    
    Returns:
  - parseGregorianCalendar
```
public static GregorianCalendar parseGregorianCalendar(String calendar,
                                                       String format)
```
    Parses the gregorian calendar.
    
    Parameters:
    
    calendar -
    
    format -
    
    Returns:
  - parseGregorianCalendar
```
public static GregorianCalendar parseGregorianCalendar(String calendar,
                                                       String format,
                                                       TimeZone timeZone)
```
    Converts the specified calendar with the specified format to a new instance of GregorianCalendar. null is returned if the specified date is null or empty.
    
    Parameters:
    
    calendar -
    
    format -
    
    timeZone -
    
    Returns:
  - parseXMLGregorianCalendar
```
public static XMLGregorianCalendar parseXMLGregorianCalendar(String calendar)
```
    Parses the XML gregorian calendar.
    
    Parameters:
    
    calendar -
    
    Returns:
  - parseXMLGregorianCalendar
```
public static XMLGregorianCalendar parseXMLGregorianCalendar(String calendar,
                                                             String format)
```
    Parses the XML gregorian calendar.
    
    Parameters:
    
    calendar -
    
    format -
    
    Returns:
  - parseXMLGregorianCalendar
```
public static XMLGregorianCalendar parseXMLGregorianCalendar(String calendar,
                                                             String format,
                                                             TimeZone timeZone)
```
    Converts the specified calendar with the specified format to a new instance of XMLGregorianCalendar. null is returned if the specified date is null or empty.
    
    Parameters:
    
    calendar -
    
    format -
    
    timeZone -
    
    Returns:
  - format
```
public static String format(Date date)
```
    Parameters:
    
    date -
    
    Returns:
  - format
```
public static String format(Date date,
                            String format)
```
    Parameters:
    
    date -
    
    format -
    
    Returns:
  - format
```
public static String format(Date date,
                            String format,
                            TimeZone timeZone)
```
    Parameters:
    
    date -
    
    format -
    
    timeZone -
    
    Returns:
  - format
```
public static void format(Writer writer,
                          Date date)
```
    Parameters:
    
    writer -
    
    date -
  - format
```
public static void format(Writer writer,
                          Date date,
                          String format)
```
    Parameters:
    
    writer -
    
    date -
    
    format -
  - format
```
public static void format(Writer writer,
                          Date date,
                          String format,
                          TimeZone timeZone)
```
    Parameters:
    
    writer -
    
    date -
    
    format -
    
    timeZone -
  - format
```
public static String format(Calendar c)
```
    Parameters:
    
    c -
    
    Returns:
  - format
```
public static String format(Calendar c,
                            String format)
```
    Parameters:
    
    c -
    
    format -
    
    Returns:
  - format
```
public static String format(Calendar c,
                            String format,
                            TimeZone timeZone)
```
    Parameters:
    
    c -
    
    format -
    
    timeZone -
    
    Returns:
  - format
```
public static void format(Writer writer,
                          Calendar c)
```
    Parameters:
    
    writer -
    
    c -
  - format
```
public static void format(Writer writer,
                          Calendar c,
                          String format)
```
    Parameters:
    
    writer -
    
    c -
    
    format -
  - format
```
public static void format(Writer writer,
                          Calendar c,
                          String format,
                          TimeZone timeZone)
```
    Parameters:
    
    writer -
    
    c -
    
    format -
    
    timeZone -
  - format
```
public static String format(XMLGregorianCalendar c)
```
    Parameters:
    
    c -
    
    Returns:
  - format
```
public static String format(XMLGregorianCalendar c,
                            String format)
```
    Parameters:
    
    c -
    
    format -
    
    Returns:
  - format
```
public static String format(XMLGregorianCalendar c,
                            String format,
                            TimeZone timeZone)
```
    Parameters:
    
    c -
    
    format -
    
    timeZone -
    
    Returns:
  - format
```
public static void format(Writer writer,
                          XMLGregorianCalendar c)
```
    Parameters:
    
    writer -
    
    c -
  - format
```
public static void format(Writer writer,
                          XMLGregorianCalendar c,
                          String format)
```
    Parameters:
    
    writer -
    
    c -
    
    format -
  - format
```
public static void format(Writer writer,
                          XMLGregorianCalendar c,
                          String format,
                          TimeZone timeZone)
```
    Parameters:
    
    writer -
    
    c -
    
    format -
    
    timeZone -
  - setYears
```
public static <T extends Date> T setYears(T date,
                                          int amount)
```
    Copied from Apache Commons Lang under Apache License v2.
    Sets the years field to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setMonths
```
public static <T extends Date> T setMonths(T date,
                                           int amount)
```
    Copied from Apache Commons Lang under Apache License v2.
    Sets the months field to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setDays
```
public static <T extends Date> T setDays(T date,
                                         int amount)
```
    Copied from Apache Commons Lang under Apache License v2.
    Sets the day of month field to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setHours
```
public static <T extends Date> T setHours(T date,
                                          int amount)
```
    Copied from Apache Commons Lang under Apache License v2.
    Sets the hours field to a date returning a new object. Hours range from 0-23. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setMinutes
```
public static <T extends Date> T setMinutes(T date,
                                            int amount)
```
    Copied from Apache Commons Lang under Apache License v2.
    Sets the minute field to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setSeconds
```
public static <T extends Date> T setSeconds(T date,
                                            int amount)
```
    Copied from Apache Commons Lang under Apache License v2.
    Sets the seconds field to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setMilliseconds
```
public static <T extends Date> T setMilliseconds(T date,
                                                 int amount)
```
    Copied from Apache Commons Lang under Apache License v2.
    Sets the milliseconds field to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - roll
```
@Deprecated
public static <T extends Date> T roll(T date,
                                                   long amount,
                                                   TimeUnit unit)
```
    Deprecated. replaced by addYears/addMonths/addWeeks/...
    
    Adds or subtracts the specified amount of time to the given time unit, based on the calendar's rules. For example, to subtract 5 days from the current time of the calendar, you can achieve it by calling:
    N.roll(date, -5, TimeUnit.DAYS).
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date -
    
    amount -
    
    unit -
    
    Returns:
    
    a new instance of Date with the specified amount rolled.
  - roll
```
@Deprecated
public static <T extends Date> T roll(T date,
                                                   long amount,
                                                   CalendarUnit unit)
```
    Deprecated. replaced by addYears/addMonths/addWeeks/...
    
    Adds or subtracts the specified amount of time to the given calendar unit, based on the calendar's rules. For example, to subtract 5 days from the current time of the calendar, you can achieve it by calling:
    N.roll(date, -5, CalendarUnit.DAY).
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date -
    
    amount -
    
    unit -
    
    Returns:
    
    a new instance of Date with the specified amount rolled.
  - roll
```
@Deprecated
public static <T extends Calendar> T roll(T calendar,
                                                       long amount,
                                                       TimeUnit unit)
```
    Deprecated. replaced by addYears/addMonths/addWeeks/...
    
    Adds or subtracts the specified amount of time to the given time unit, based on the calendar's rules. For example, to subtract 5 days from the current time of the calendar, you can achieve it by calling:
    N.roll(c, -5, TimeUnit.DAYS).
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar -
    
    amount -
    
    unit -
    
    Returns:
    
    a new instance of Calendar with the specified amount rolled.
  - roll
```
@Deprecated
public static <T extends Calendar> T roll(T calendar,
                                                       long amount,
                                                       CalendarUnit unit)
```
    Deprecated. replaced by addYears/addMonths/addWeeks/...
    
    Adds or subtracts the specified amount of time to the given calendar unit, based on the calendar's rules. For example, to subtract 5 days from the current time of the calendar, you can achieve it by calling:
    N.roll(c, -5, CalendarUnit.DAY).
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar -
    
    amount -
    
    unit -
    
    Returns:
    
    a new instance of Calendar with the specified amount rolled.
  - addYears
```
public static <T extends Date> T addYears(T date,
                                          int amount)
```
    Adds a number of years to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
  - addMonths
```
public static <T extends Date> T addMonths(T date,
                                           int amount)
```
    Adds a number of months to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
  - addWeeks
```
public static <T extends Date> T addWeeks(T date,
                                          int amount)
```
    Adds a number of weeks to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
  - addDays
```
public static <T extends Date> T addDays(T date,
                                         int amount)
```
    Adds a number of days to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
  - addHours
```
public static <T extends Date> T addHours(T date,
                                          int amount)
```
    Adds a number of hours to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
  - addMinutes
```
public static <T extends Date> T addMinutes(T date,
                                            int amount)
```
    Adds a number of minutes to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
  - addSeconds
```
public static <T extends Date> T addSeconds(T date,
                                            int amount)
```
    Adds a number of seconds to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
  - addMilliseconds
```
public static <T extends Date> T addMilliseconds(T date,
                                                 int amount)
```
    Adds a number of milliseconds to a date returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
  - addYears
```
public static <T extends Calendar> T addYears(T calendar,
                                              int amount)
```
    Adds a number of years to a calendar returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the calendar is null
  - addMonths
```
public static <T extends Calendar> T addMonths(T calendar,
                                               int amount)
```
    Adds a number of months to a calendar returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the calendar is null
  - addWeeks
```
public static <T extends Calendar> T addWeeks(T calendar,
                                              int amount)
```
    Adds a number of weeks to a calendar returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the calendar is null
  - addDays
```
public static <T extends Calendar> T addDays(T calendar,
                                             int amount)
```
    Adds a number of days to a calendar returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the calendar is null
  - addHours
```
public static <T extends Calendar> T addHours(T calendar,
                                              int amount)
```
    Adds a number of hours to a calendar returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the calendar is null
  - addMinutes
```
public static <T extends Calendar> T addMinutes(T calendar,
                                                int amount)
```
    Adds a number of minutes to a calendar returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the calendar is null
  - addSeconds
```
public static <T extends Calendar> T addSeconds(T calendar,
                                                int amount)
```
    Adds a number of seconds to a calendar returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the calendar is null
  - addMilliseconds
```
public static <T extends Calendar> T addMilliseconds(T calendar,
                                                     int amount)
```
    Adds a number of milliseconds to a calendar returning a new object. The original Date is unchanged.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the calendar is null
  - round
```
public static <T extends Date> T round(T date,
                                       int field)
```
    Copied from Apache Commons Lang under Apache License v2.
    
    Rounds a date, leaving the field specified as the most significant field.
    
    For example, if you had the date-time 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:
    - March 30, 2003 01:10 rounds to March 30, 2003 01:00
    - March 30, 2003 01:40 rounds to March 30, 2003 03:00
    - March 30, 2003 02:10 rounds to March 30, 2003 03:00
    - March 30, 2003 02:40 rounds to March 30, 2003 04:00
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    Throws:
    
    ArithmeticException - if the year is over 280 million
  - round
```
public static <T extends Calendar> T round(T calendar,
                                           int field)
```
    Copied from Apache Commons Lang under Apache License v2.
    
    Rounds a date, leaving the field specified as the most significant field.
    
    For example, if you had the date-time 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:
    - March 30, 2003 01:10 rounds to March 30, 2003 01:00
    - March 30, 2003 01:40 rounds to March 30, 2003 03:00
    - March 30, 2003 02:10 rounds to March 30, 2003 03:00
    - March 30, 2003 02:40 rounds to March 30, 2003 04:00
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    ArithmeticException - if the year is over 280 million
  - truncate
```
public static <T extends Date> T truncate(T date,
                                          int field)
```
    Copied from Apache Commons Lang under Apache License v2.
    
    Truncates a date, leaving the field specified as the most significant field.
    
    For example, if you had the date-time 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.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    ArithmeticException - if the year is over 280 million
  - truncate
```
public static <T extends Calendar> T truncate(T calendar,
                                              int field)
```
    Copied from Apache Commons Lang under Apache License v2.
    
    Truncates a date, leaving the field specified as the most significant field.
    
    For example, if you had the date-time 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.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    ArithmeticException - if the year is over 280 million
  - ceiling
```
public static <T extends Date> T ceiling(T date,
                                         int field)
```
    Copied from Apache Commons Lang under Apache License v2.
    
    Gets a date ceiling, leaving the field specified as the most significant field.
    
    For example, if you had the date-time of 28 Mar 2002 13:45:01.231, if you passed with HOUR, it would return 28 Mar 2002 14:00:00.000. If this was passed with MONTH, it would return 1 Apr 2002 0:00:00.000.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    date - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    ArithmeticException - if the year is over 280 million
    
    Since:
    
    2.5
  - ceiling
```
public static <T extends Calendar> T ceiling(T calendar,
                                             int field)
```
    Copied from Apache Commons Lang under Apache License v2.
    
    Gets a date ceiling, leaving the field specified as the most significant field.
    
    For example, if you had the date-time of 28 Mar 2002 13:45:01.231, if you passed with HOUR, it would return 28 Mar 2002 14:00:00.000. If this was passed with MONTH, it would return 1 Apr 2002 0:00:00.000.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    calendar - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    Throws:
    
    IllegalArgumentException - if the date is null
    
    ArithmeticException - if the year is over 280 million
    
    Since:
    
    2.5
  - truncatedEquals
```
public static boolean truncatedEquals(Calendar cal1,
                                      Calendar cal2,
                                      int field)
```
    Copied from Apache Commons Lang under Apache License v2.
    Determines if two calendars are equal up to no more than the specified most significant field.
    
    Parameters:
    
    cal1 - the first calendar, not null
    
    cal2 - the second calendar, not null
    
    field - the field from Calendar
    
    Returns:
    
    true if equal; otherwise false
    
    Throws:
    
    IllegalArgumentException - if any argument is null
    
    Since:
    
    3.0
    
    See Also:
    
    truncate(Calendar, int), truncatedEquals(Date, Date, int)
  - truncatedEquals
```
public static boolean truncatedEquals(Date date1,
                                      Date date2,
                                      int field)
```
    Copied from Apache Commons Lang under Apache License v2.
    Determines if two dates are equal up to no more than the specified most significant field.
    
    Parameters:
    
    date1 - the first date, not null
    
    date2 - the second date, not null
    
    field - the field from Calendar
    
    Returns:
    
    true if equal; otherwise false
    
    Throws:
    
    IllegalArgumentException - if any argument is null
    
    Since:
    
    3.0
    
    See Also:
    
    truncate(Date, int), truncatedEquals(Calendar, Calendar, int)
  - truncatedCompareTo
```
public static int truncatedCompareTo(Calendar cal1,
                                     Calendar cal2,
                                     int field)
```
    Copied from Apache Commons Lang under Apache License v2.
    Determines how two calendars compare up to no more than the specified most significant field.
    
    Parameters:
    
    cal1 - the first calendar, not null
    
    cal2 - the second calendar, not null
    
    field - the field from Calendar
    
    Returns:
    
    a negative integer, zero, or a positive integer as the first calendar is less than, equal to, or greater than the second.
    
    Throws:
    
    IllegalArgumentException - if any argument is null
    
    Since:
    
    3.0
    
    See Also:
    
    truncate(Calendar, int), truncatedCompareTo(Date, Date, int)
  - truncatedCompareTo
```
public static int truncatedCompareTo(Date date1,
                                     Date date2,
                                     int field)
```
    Copied from Apache Commons Lang under Apache License v2.
    Determines how two dates compare up to no more than the specified most significant field.
    
    Parameters:
    
    date1 - the first date, not null
    
    date2 - the second date, not null
    
    field - the field from Calendar
    
    Returns:
    
    a negative integer, zero, or a positive integer as the first date is less than, equal to, or greater than the second.
    
    Throws:
    
    IllegalArgumentException - if any argument is null
    
    Since:
    
    3.0
    
    See Also:
    
    truncate(Calendar, int), truncatedCompareTo(Date, Date, int)

Class DateUtil

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

UTC_TIME_ZONE

LOCAL_TIME_ZONE

LOCAL_YEAR_FORMAT

LOCAL_MONTH_DAY_FORMAT

LOCAL_DATE_FORMAT

LOCAL_TIME_FORMAT

LOCAL_DATETIME_FORMAT

LOCAL_TIMESTAMP_FORMAT

ISO_8601_DATETIME_FORMAT

ISO_8601_TIMESTAMP_FORMAT

RFC1123_DATE_FORMAT

SEMI_MONTH

Method Detail

currentTime

currentDate

currentTimestamp

currentJUDate

currentCalendar

currentGregorianCalendar

currentXMLGregorianCalendar

createJUDate

createJUDate

createJUDate

createDate

createDate

createDate

createTime

createTime

createTime

createTimestamp

createTimestamp

createTimestamp

createCalendar

createCalendar

createCalendar

createCalendar

createGregorianCalendar

createGregorianCalendar

createGregorianCalendar

createGregorianCalendar

createXMLGregorianCalendar

createXMLGregorianCalendar

createXMLGregorianCalendar

parseJUDate

parseJUDate

parseJUDate

parseDate

parseDate

parseDate

parseTime

parseTime

parseTime

parseTimestamp

parseTimestamp

parseTimestamp

parseCalendar

parseCalendar

parseCalendar

parseGregorianCalendar

parseGregorianCalendar

parseGregorianCalendar

parseXMLGregorianCalendar

parseXMLGregorianCalendar

parseXMLGregorianCalendar

format

format

format

format

format

format

format

format

format

format