DateUtil (abacus API Documentation)

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

Direct Known Subclasses:

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

1.2.6

Author:

Haiyang Li

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class DateUtil.DateTimeUtil

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

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`ISO_8601_DATETIME_FORMAT` It's default date/time format.
`static java.lang.String`	`ISO_8601_TIMESTAMP_FORMAT` It's default timestamp format.
`static java.lang.String`	`LOCAL_DATE_FORMAT`
`static java.lang.String`	`LOCAL_DATETIME_FORMAT`
`static java.lang.String`	`LOCAL_MONTH_DAY_FORMAT`
`static java.lang.String`	`LOCAL_TIME_FORMAT`
`static java.util.TimeZone`	`LOCAL_TIME_ZONE` The system default time zone
`static java.lang.String`	`LOCAL_TIMESTAMP_FORMAT`
`static java.lang.String`	`LOCAL_YEAR_FORMAT` Date format.
`static java.lang.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 java.util.TimeZone`	`UTC_TIME_ZONE`

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static <T extends java.util.Calendar> T`	`addDays(T calendar, int amount)` Adds a number of days to a calendar returning a new object.
`static <T extends java.util.Date> T`	`addDays(T date, int amount)` Adds a number of days to a date returning a new object.
`static <T extends java.util.Calendar> T`	`addHours(T calendar, int amount)` Adds a number of hours to a calendar returning a new object.
`static <T extends java.util.Date> T`	`addHours(T date, int amount)` Adds a number of hours to a date returning a new object.
`static <T extends java.util.Calendar> T`	`addMilliseconds(T calendar, int amount)` Adds a number of milliseconds to a calendar returning a new object.
`static <T extends java.util.Date> T`	`addMilliseconds(T date, int amount)` Adds a number of milliseconds to a date returning a new object.
`static <T extends java.util.Calendar> T`	`addMinutes(T calendar, int amount)` Adds a number of minutes to a calendar returning a new object.
`static <T extends java.util.Date> T`	`addMinutes(T date, int amount)` Adds a number of minutes to a date returning a new object.
`static <T extends java.util.Calendar> T`	`addMonths(T calendar, int amount)` Adds a number of months to a calendar returning a new object.
`static <T extends java.util.Date> T`	`addMonths(T date, int amount)` Adds a number of months to a date returning a new object.
`static <T extends java.util.Calendar> T`	`addSeconds(T calendar, int amount)` Adds a number of seconds to a calendar returning a new object.
`static <T extends java.util.Date> T`	`addSeconds(T date, int amount)` Adds a number of seconds to a date returning a new object.
`static <T extends java.util.Calendar> T`	`addWeeks(T calendar, int amount)` Adds a number of weeks to a calendar returning a new object.
`static <T extends java.util.Date> T`	`addWeeks(T date, int amount)` Adds a number of weeks to a date returning a new object.
`static <T extends java.util.Calendar> T`	`addYears(T calendar, int amount)` Adds a number of years to a calendar returning a new object.
`static <T extends java.util.Date> T`	`addYears(T date, int amount)` Adds a number of years to a date returning a new object.
`static <T extends java.util.Calendar> T`	`ceiling(T calendar, int field)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Date> T`	`ceiling(T date, int field)` Copied from Apache Commons Lang under Apache License v2.
`static java.util.Calendar`	`createCalendar(java.util.Calendar calendar)`
`static java.util.Calendar`	`createCalendar(java.util.Date date)`
`static java.util.Calendar`	`createCalendar(long timeInMillis)`
`static java.util.Calendar`	`createCalendar(long timeInMillis, java.util.TimeZone tz)`
`static java.sql.Date`	`createDate(java.util.Calendar calendar)`
`static java.sql.Date`	`createDate(java.util.Date date)`
`static java.sql.Date`	`createDate(long timeInMillis)`
`static java.util.GregorianCalendar`	`createGregorianCalendar(java.util.Calendar calendar)`
`static java.util.GregorianCalendar`	`createGregorianCalendar(java.util.Date date)`
`static java.util.GregorianCalendar`	`createGregorianCalendar(long timeInMillis)`
`static java.util.GregorianCalendar`	`createGregorianCalendar(long timeInMillis, java.util.TimeZone tz)`
`static java.util.Date`	`createJUDate(java.util.Calendar calendar)`
`static java.util.Date`	`createJUDate(java.util.Date date)`
`static java.util.Date`	`createJUDate(long timeInMillis)`
`static java.sql.Time`	`createTime(java.util.Calendar calendar)`
`static java.sql.Time`	`createTime(java.util.Date date)`
`static java.sql.Time`	`createTime(long timeInMillis)`
`static java.sql.Timestamp`	`createTimestamp(java.util.Calendar calendar)`
`static java.sql.Timestamp`	`createTimestamp(java.util.Date date)`
`static java.sql.Timestamp`	`createTimestamp(long timeInMillis)`
`static javax.xml.datatype.XMLGregorianCalendar`	`createXMLGregorianCalendar(java.util.Calendar calendar)`
`static javax.xml.datatype.XMLGregorianCalendar`	`createXMLGregorianCalendar(java.util.Date date)`
`static javax.xml.datatype.XMLGregorianCalendar`	`createXMLGregorianCalendar(long timeInMillis)`
`static java.util.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 java.sql.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 java.util.GregorianCalendar`	`currentGregorianCalendar()`
`static java.util.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 java.sql.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 java.sql.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 javax.xml.datatype.XMLGregorianCalendar`	`currentXMLGregorianCalendar()`
`static java.lang.String`	`format(java.util.Calendar c)`
`static java.lang.String`	`format(java.util.Calendar c, java.lang.String format)`
`static java.lang.String`	`format(java.util.Calendar c, java.lang.String format, java.util.TimeZone timeZone)`
`static java.lang.String`	`format(java.util.Date date)`
`static java.lang.String`	`format(java.util.Date date, java.lang.String format)`
`static java.lang.String`	`format(java.util.Date date, java.lang.String format, java.util.TimeZone timeZone)`
`static void`	`format(java.io.Writer writer, java.util.Calendar c)`
`static void`	`format(java.io.Writer writer, java.util.Calendar c, java.lang.String format)`
`static void`	`format(java.io.Writer writer, java.util.Calendar c, java.lang.String format, java.util.TimeZone timeZone)`
`static void`	`format(java.io.Writer writer, java.util.Date date)`
`static void`	`format(java.io.Writer writer, java.util.Date date, java.lang.String format)`
`static void`	`format(java.io.Writer writer, java.util.Date date, java.lang.String format, java.util.TimeZone timeZone)`
`static void`	`format(java.io.Writer writer, javax.xml.datatype.XMLGregorianCalendar c)`
`static void`	`format(java.io.Writer writer, javax.xml.datatype.XMLGregorianCalendar c, java.lang.String format)`
`static void`	`format(java.io.Writer writer, javax.xml.datatype.XMLGregorianCalendar c, java.lang.String format, java.util.TimeZone timeZone)`
`static java.lang.String`	`format(javax.xml.datatype.XMLGregorianCalendar c)`
`static java.lang.String`	`format(javax.xml.datatype.XMLGregorianCalendar c, java.lang.String format)`
`static java.lang.String`	`format(javax.xml.datatype.XMLGregorianCalendar c, java.lang.String format, java.util.TimeZone timeZone)`
`static java.util.Calendar`	`parseCalendar(java.lang.String calendar)`
`static java.util.Calendar`	`parseCalendar(java.lang.String calendar, java.lang.String format)`
`static java.util.Calendar`	`parseCalendar(java.lang.String calendar, java.lang.String format, java.util.TimeZone timeZone)` Converts the specified `calendar` with the specified `format` to a new instance of Calendar.
`static java.sql.Date`	`parseDate(java.lang.String date)`
`static java.sql.Date`	`parseDate(java.lang.String date, java.lang.String format)`
`static java.sql.Date`	`parseDate(java.lang.String date, java.lang.String format, java.util.TimeZone timeZone)` Converts the specified `date` with the specified `format` to a new instance of java.sql.Date.
`static java.util.GregorianCalendar`	`parseGregorianCalendar(java.lang.String calendar)`
`static java.util.GregorianCalendar`	`parseGregorianCalendar(java.lang.String calendar, java.lang.String format)`
`static java.util.GregorianCalendar`	`parseGregorianCalendar(java.lang.String calendar, java.lang.String format, java.util.TimeZone timeZone)` Converts the specified `calendar` with the specified `format` to a new instance of GregorianCalendar.
`static java.util.Date`	`parseJUDate(java.lang.String date)`
`static java.util.Date`	`parseJUDate(java.lang.String date, java.lang.String format)`
`static java.util.Date`	`parseJUDate(java.lang.String date, java.lang.String format, java.util.TimeZone timeZone)` Converts the specified `date` with the specified `format` to a new instance of java.util.Date.
`static java.sql.Time`	`parseTime(java.lang.String date)`
`static java.sql.Time`	`parseTime(java.lang.String date, java.lang.String format)`
`static java.sql.Time`	`parseTime(java.lang.String date, java.lang.String format, java.util.TimeZone timeZone)` Converts the specified `date` with the specified `format` to a new instance of Time.
`static java.sql.Timestamp`	`parseTimestamp(java.lang.String date)`
`static java.sql.Timestamp`	`parseTimestamp(java.lang.String date, java.lang.String format)`
`static java.sql.Timestamp`	`parseTimestamp(java.lang.String date, java.lang.String format, java.util.TimeZone timeZone)` Converts the specified `date` with the specified `format` to a new instance of Timestamp.
`static javax.xml.datatype.XMLGregorianCalendar`	`parseXMLGregorianCalendar(java.lang.String calendar)`
`static javax.xml.datatype.XMLGregorianCalendar`	`parseXMLGregorianCalendar(java.lang.String calendar, java.lang.String format)`
`static javax.xml.datatype.XMLGregorianCalendar`	`parseXMLGregorianCalendar(java.lang.String calendar, java.lang.String format, java.util.TimeZone timeZone)` Converts the specified `calendar` with the specified `format` to a new instance of XMLGregorianCalendar.
`static <T extends java.util.Calendar> T`	`roll(T calendar, long amount, CalendarUnit unit)` Deprecated. replaced by `addYears/addMonths/addWeeks/...`
`static <T extends java.util.Date> T`	`roll(T date, long amount, CalendarUnit unit)` Deprecated. replaced by `addYears/addMonths/addWeeks/...`
`static <T extends java.util.Calendar> T`	`roll(T calendar, long amount, java.util.concurrent.TimeUnit unit)` Deprecated. replaced by `addYears/addMonths/addWeeks/...`
`static <T extends java.util.Date> T`	`roll(T date, long amount, java.util.concurrent.TimeUnit unit)` Deprecated. replaced by `addYears/addMonths/addWeeks/...`
`static <T extends java.util.Calendar> T`	`round(T calendar, int field)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Date> T`	`round(T date, int field)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Date> T`	`setDays(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Date> T`	`setHours(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Date> T`	`setMilliseconds(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Date> T`	`setMinutes(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Date> T`	`setMonths(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Date> T`	`setSeconds(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Date> T`	`setYears(T date, int amount)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Calendar> T`	`truncate(T calendar, int field)` Copied from Apache Commons Lang under Apache License v2.
`static <T extends java.util.Date> T`	`truncate(T date, int field)` Copied from Apache Commons Lang under Apache License v2.
`static int`	`truncatedCompareTo(java.util.Calendar cal1, java.util.Calendar cal2, int field)` Copied from Apache Commons Lang under Apache License v2.
`static int`	`truncatedCompareTo(java.util.Date date1, java.util.Date date2, int field)` Copied from Apache Commons Lang under Apache License v2.
`static boolean`	`truncatedEquals(java.util.Calendar cal1, java.util.Calendar cal2, int field)` Copied from Apache Commons Lang under Apache License v2.
`static boolean`	`truncatedEquals(java.util.Date date1, java.util.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 java.util.TimeZone UTC_TIME_ZONE
```
  - LOCAL_TIME_ZONE
```
public static final java.util.TimeZone LOCAL_TIME_ZONE
```
    The system default time zone
  - LOCAL_YEAR_FORMAT
```
public static final java.lang.String LOCAL_YEAR_FORMAT
```
    Date format.
    
    See Also:
    
    Constant Field Values
  - LOCAL_MONTH_DAY_FORMAT
```
public static final java.lang.String LOCAL_MONTH_DAY_FORMAT
```
    See Also:
    
    Constant Field Values
  - LOCAL_DATE_FORMAT
```
public static final java.lang.String LOCAL_DATE_FORMAT
```
    See Also:
    
    Constant Field Values
  - LOCAL_TIME_FORMAT
```
public static final java.lang.String LOCAL_TIME_FORMAT
```
    See Also:
    
    Constant Field Values
  - LOCAL_DATETIME_FORMAT
```
public static final java.lang.String LOCAL_DATETIME_FORMAT
```
    See Also:
    
    Constant Field Values
  - LOCAL_TIMESTAMP_FORMAT
```
public static final java.lang.String LOCAL_TIMESTAMP_FORMAT
```
    See Also:
    
    Constant Field Values
  - ISO_8601_DATETIME_FORMAT
```
public static final java.lang.String ISO_8601_DATETIME_FORMAT
```
    It's default date/time format.
    
    See Also:
    
    Constant Field Values
  - ISO_8601_TIMESTAMP_FORMAT
```
public static final java.lang.String ISO_8601_TIMESTAMP_FORMAT
```
    It's default timestamp format.
    
    See Also:
    
    Constant Field Values
  - RFC1123_DATE_FORMAT
```
public static final java.lang.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 java.sql.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 java.sql.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 java.sql.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 java.util.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 java.util.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 java.util.GregorianCalendar currentGregorianCalendar()
```
  - currentXMLGregorianCalendar
```
public static javax.xml.datatype.XMLGregorianCalendar currentXMLGregorianCalendar()
```
  - createJUDate
```
public static java.util.Date createJUDate(java.util.Calendar calendar)
```
  - createJUDate
```
public static java.util.Date createJUDate(java.util.Date date)
```
  - createJUDate
```
public static java.util.Date createJUDate(long timeInMillis)
```
  - createDate
```
public static java.sql.Date createDate(java.util.Calendar calendar)
```
  - createDate
```
public static java.sql.Date createDate(java.util.Date date)
```
  - createDate
```
public static java.sql.Date createDate(long timeInMillis)
```
  - createTime
```
public static java.sql.Time createTime(java.util.Calendar calendar)
```
  - createTime
```
public static java.sql.Time createTime(java.util.Date date)
```
  - createTime
```
public static java.sql.Time createTime(long timeInMillis)
```
  - createTimestamp
```
public static java.sql.Timestamp createTimestamp(java.util.Calendar calendar)
```
  - createTimestamp
```
public static java.sql.Timestamp createTimestamp(java.util.Date date)
```
  - createTimestamp
```
public static java.sql.Timestamp createTimestamp(long timeInMillis)
```
  - createCalendar
```
public static java.util.Calendar createCalendar(java.util.Calendar calendar)
```
  - createCalendar
```
public static java.util.Calendar createCalendar(java.util.Date date)
```
  - createCalendar
```
public static java.util.Calendar createCalendar(long timeInMillis)
```
  - createCalendar
```
public static java.util.Calendar createCalendar(long timeInMillis,
                                                java.util.TimeZone tz)
```
  - createGregorianCalendar
```
public static java.util.GregorianCalendar createGregorianCalendar(java.util.Calendar calendar)
```
  - createGregorianCalendar
```
public static java.util.GregorianCalendar createGregorianCalendar(java.util.Date date)
```
  - createGregorianCalendar
```
public static java.util.GregorianCalendar createGregorianCalendar(long timeInMillis)
```
  - createGregorianCalendar
```
public static java.util.GregorianCalendar createGregorianCalendar(long timeInMillis,
                                                                  java.util.TimeZone tz)
```
  - createXMLGregorianCalendar
```
public static javax.xml.datatype.XMLGregorianCalendar createXMLGregorianCalendar(java.util.Calendar calendar)
```
  - createXMLGregorianCalendar
```
public static javax.xml.datatype.XMLGregorianCalendar createXMLGregorianCalendar(java.util.Date date)
```
  - createXMLGregorianCalendar
```
public static javax.xml.datatype.XMLGregorianCalendar createXMLGregorianCalendar(long timeInMillis)
```
  - parseJUDate
```
public static java.util.Date parseJUDate(java.lang.String date)
```
  - parseJUDate
```
public static java.util.Date parseJUDate(java.lang.String date,
                                         java.lang.String format)
```
  - parseJUDate
```
public static java.util.Date parseJUDate(java.lang.String date,
                                         java.lang.String format,
                                         java.util.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 -
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date given can't be parsed with specified format.
  - parseDate
```
public static java.sql.Date parseDate(java.lang.String date)
```
  - parseDate
```
public static java.sql.Date parseDate(java.lang.String date,
                                      java.lang.String format)
```
  - parseDate
```
public static java.sql.Date parseDate(java.lang.String date,
                                      java.lang.String format,
                                      java.util.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 java.sql.Time parseTime(java.lang.String date)
```
  - parseTime
```
public static java.sql.Time parseTime(java.lang.String date,
                                      java.lang.String format)
```
  - parseTime
```
public static java.sql.Time parseTime(java.lang.String date,
                                      java.lang.String format,
                                      java.util.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 java.sql.Timestamp parseTimestamp(java.lang.String date)
```
  - parseTimestamp
```
public static java.sql.Timestamp parseTimestamp(java.lang.String date,
                                                java.lang.String format)
```
  - parseTimestamp
```
public static java.sql.Timestamp parseTimestamp(java.lang.String date,
                                                java.lang.String format,
                                                java.util.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 java.util.Calendar parseCalendar(java.lang.String calendar)
```
  - parseCalendar
```
public static java.util.Calendar parseCalendar(java.lang.String calendar,
                                               java.lang.String format)
```
  - parseCalendar
```
public static java.util.Calendar parseCalendar(java.lang.String calendar,
                                               java.lang.String format,
                                               java.util.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 java.util.GregorianCalendar parseGregorianCalendar(java.lang.String calendar)
```
  - parseGregorianCalendar
```
public static java.util.GregorianCalendar parseGregorianCalendar(java.lang.String calendar,
                                                                 java.lang.String format)
```
  - parseGregorianCalendar
```
public static java.util.GregorianCalendar parseGregorianCalendar(java.lang.String calendar,
                                                                 java.lang.String format,
                                                                 java.util.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 javax.xml.datatype.XMLGregorianCalendar parseXMLGregorianCalendar(java.lang.String calendar)
```
  - parseXMLGregorianCalendar
```
public static javax.xml.datatype.XMLGregorianCalendar parseXMLGregorianCalendar(java.lang.String calendar,
                                                                                java.lang.String format)
```
  - parseXMLGregorianCalendar
```
public static javax.xml.datatype.XMLGregorianCalendar parseXMLGregorianCalendar(java.lang.String calendar,
                                                                                java.lang.String format,
                                                                                java.util.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 java.lang.String format(java.util.Date date)
```
  - format
```
public static java.lang.String format(java.util.Date date,
                                      java.lang.String format)
```
  - format
```
public static java.lang.String format(java.util.Date date,
                                      java.lang.String format,
                                      java.util.TimeZone timeZone)
```
  - format
```
public static void format(java.io.Writer writer,
                          java.util.Date date)
```
  - format
```
public static void format(java.io.Writer writer,
                          java.util.Date date,
                          java.lang.String format)
```
  - format
```
public static void format(java.io.Writer writer,
                          java.util.Date date,
                          java.lang.String format,
                          java.util.TimeZone timeZone)
```
  - format
```
public static java.lang.String format(java.util.Calendar c)
```
  - format
```
public static java.lang.String format(java.util.Calendar c,
                                      java.lang.String format)
```
  - format
```
public static java.lang.String format(java.util.Calendar c,
                                      java.lang.String format,
                                      java.util.TimeZone timeZone)
```
  - format
```
public static void format(java.io.Writer writer,
                          java.util.Calendar c)
```
  - format
```
public static void format(java.io.Writer writer,
                          java.util.Calendar c,
                          java.lang.String format)
```
  - format
```
public static void format(java.io.Writer writer,
                          java.util.Calendar c,
                          java.lang.String format,
                          java.util.TimeZone timeZone)
```
  - format
```
public static java.lang.String format(javax.xml.datatype.XMLGregorianCalendar c)
```
  - format
```
public static java.lang.String format(javax.xml.datatype.XMLGregorianCalendar c,
                                      java.lang.String format)
```
  - format
```
public static java.lang.String format(javax.xml.datatype.XMLGregorianCalendar c,
                                      java.lang.String format,
                                      java.util.TimeZone timeZone)
```
  - format
```
public static void format(java.io.Writer writer,
                          javax.xml.datatype.XMLGregorianCalendar c)
```
  - format
```
public static void format(java.io.Writer writer,
                          javax.xml.datatype.XMLGregorianCalendar c,
                          java.lang.String format)
```
  - format
```
public static void format(java.io.Writer writer,
                          javax.xml.datatype.XMLGregorianCalendar c,
                          java.lang.String format,
                          java.util.TimeZone timeZone)
```
  - setYears
```
public static <T extends java.util.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.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setMonths
```
public static <T extends java.util.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.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setDays
```
public static <T extends java.util.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.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setHours
```
public static <T extends java.util.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.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setMinutes
```
public static <T extends java.util.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.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setSeconds
```
public static <T extends java.util.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.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - setMilliseconds
```
public static <T extends java.util.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.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to set
    
    Returns:
    
    a new Date set with the specified value
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    Since:
    
    2.4
  - roll
```
@Deprecated
public static <T extends java.util.Date> T roll(T date,
                                                             long amount,
                                                             java.util.concurrent.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).
    
    Parameters:
    
    date -
    
    amount -
    
    unit -
    
    Returns:
    
    a new instance of Date with the specified amount rolled.
  - roll
```
@Deprecated
public static <T extends java.util.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).
    
    Parameters:
    
    date -
    
    amount -
    
    unit -
    
    Returns:
    
    a new instance of Date with the specified amount rolled.
  - roll
```
@Deprecated
public static <T extends java.util.Calendar> T roll(T calendar,
                                                                 long amount,
                                                                 java.util.concurrent.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).
    
    Parameters:
    
    calendar -
    
    amount -
    
    unit -
    
    Returns:
    
    a new instance of Calendar with the specified amount rolled.
  - roll
```
@Deprecated
public static <T extends java.util.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).
    
    Parameters:
    
    calendar -
    
    amount -
    
    unit -
    
    Returns:
    
    a new instance of Calendar with the specified amount rolled.
  - addYears
```
public static <T extends java.util.Date> T addYears(T date,
                                                    int amount)
```
    Adds a number of years to a date returning a new object. The original Date is unchanged.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
  - addMonths
```
public static <T extends java.util.Date> T addMonths(T date,
                                                     int amount)
```
    Adds a number of months to a date returning a new object. The original Date is unchanged.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
  - addWeeks
```
public static <T extends java.util.Date> T addWeeks(T date,
                                                    int amount)
```
    Adds a number of weeks to a date returning a new object. The original Date is unchanged.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
  - addDays
```
public static <T extends java.util.Date> T addDays(T date,
                                                   int amount)
```
    Adds a number of days to a date returning a new object. The original Date is unchanged.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
  - addHours
```
public static <T extends java.util.Date> T addHours(T date,
                                                    int amount)
```
    Adds a number of hours to a date returning a new object. The original Date is unchanged.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
  - addMinutes
```
public static <T extends java.util.Date> T addMinutes(T date,
                                                      int amount)
```
    Adds a number of minutes to a date returning a new object. The original Date is unchanged.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
  - addSeconds
```
public static <T extends java.util.Date> T addSeconds(T date,
                                                      int amount)
```
    Adds a number of seconds to a date returning a new object. The original Date is unchanged.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
  - addMilliseconds
```
public static <T extends java.util.Date> T addMilliseconds(T date,
                                                           int amount)
```
    Adds a number of milliseconds to a date returning a new object. The original Date is unchanged.
    
    Parameters:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
  - addYears
```
public static <T extends java.util.Calendar> T addYears(T calendar,
                                                        int amount)
```
    Adds a number of years to a calendar returning a new object. The original Date is unchanged.
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the calendar is null
  - addMonths
```
public static <T extends java.util.Calendar> T addMonths(T calendar,
                                                         int amount)
```
    Adds a number of months to a calendar returning a new object. The original Date is unchanged.
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the calendar is null
  - addWeeks
```
public static <T extends java.util.Calendar> T addWeeks(T calendar,
                                                        int amount)
```
    Adds a number of weeks to a calendar returning a new object. The original Date is unchanged.
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the calendar is null
  - addDays
```
public static <T extends java.util.Calendar> T addDays(T calendar,
                                                       int amount)
```
    Adds a number of days to a calendar returning a new object. The original Date is unchanged.
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the calendar is null
  - addHours
```
public static <T extends java.util.Calendar> T addHours(T calendar,
                                                        int amount)
```
    Adds a number of hours to a calendar returning a new object. The original Date is unchanged.
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the calendar is null
  - addMinutes
```
public static <T extends java.util.Calendar> T addMinutes(T calendar,
                                                          int amount)
```
    Adds a number of minutes to a calendar returning a new object. The original Date is unchanged.
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the calendar is null
  - addSeconds
```
public static <T extends java.util.Calendar> T addSeconds(T calendar,
                                                          int amount)
```
    Adds a number of seconds to a calendar returning a new object. The original Date is unchanged.
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the calendar is null
  - addMilliseconds
```
public static <T extends java.util.Calendar> T addMilliseconds(T calendar,
                                                               int amount)
```
    Adds a number of milliseconds to a calendar returning a new object. The original Date is unchanged.
    
    Parameters:
    
    calendar - the calendar, not null
    
    amount - the amount to add, may be negative
    
    Returns:
    
    the new Date with the amount added
    
    Throws:
    
    java.lang.IllegalArgumentException - if the calendar is null
  - round
```
public static <T extends java.util.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
    Parameters:
    
    date - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    the different rounded date, not null
    
    Throws:
    
    java.lang.ArithmeticException - if the year is over 280 million
  - round
```
public static <T extends java.util.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
    Parameters:
    
    calendar - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    the different rounded date, not null
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    java.lang.ArithmeticException - if the year is over 280 million
  - truncate
```
public static <T extends java.util.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.
    
    Parameters:
    
    date - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    the different truncated date, not null
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    java.lang.ArithmeticException - if the year is over 280 million
  - truncate
```
public static <T extends java.util.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.
    
    Parameters:
    
    calendar - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    the different truncated date, not null
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    java.lang.ArithmeticException - if the year is over 280 million
  - ceiling
```
public static <T extends java.util.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.
    
    Parameters:
    
    date - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    the different ceil date, not null
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    java.lang.ArithmeticException - if the year is over 280 million
    
    Since:
    
    2.5
  - ceiling
```
public static <T extends java.util.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.
    
    Parameters:
    
    calendar - the date to work with, not null
    
    field - the field from Calendar or SEMI_MONTH
    
    Returns:
    
    the different ceil date, not null
    
    Throws:
    
    java.lang.IllegalArgumentException - if the date is null
    
    java.lang.ArithmeticException - if the year is over 280 million
    
    Since:
    
    2.5
  - truncatedEquals
```
public static boolean truncatedEquals(java.util.Calendar cal1,
                                      java.util.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:
    
    java.lang.IllegalArgumentException - if any argument is null
    
    Since:
    
    3.0
    
    See Also:
    
    truncate(Calendar, int), truncatedEquals(Date, Date, int)
  - truncatedEquals
```
public static boolean truncatedEquals(java.util.Date date1,
                                      java.util.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:
    
    java.lang.IllegalArgumentException - if any argument is null
    
    Since:
    
    3.0
    
    See Also:
    
    truncate(Date, int), truncatedEquals(Calendar, Calendar, int)
  - truncatedCompareTo
```
public static int truncatedCompareTo(java.util.Calendar cal1,
                                     java.util.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:
    
    java.lang.IllegalArgumentException - if any argument is null
    
    Since:
    
    3.0
    
    See Also:
    
    truncate(Calendar, int), truncatedCompareTo(Date, Date, int)
  - truncatedCompareTo
```
public static int truncatedCompareTo(java.util.Date date1,
                                     java.util.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:
    
    java.lang.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