com.landawn.abacus.util

Class DateUtil

java.lang.Object

com.landawn.abacus.util.DateUtil

public final class DateUtil
extends java.lang.Object

Since:

1.2.6

Author:

Haiyang Li

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 java.util.TimeZone	UTC_TIME_ZONE

Method Summary

Modifier and Type	Method and Description
static java.util.Calendar	asCalendar(java.util.Calendar c)
static java.util.Calendar	asCalendar(java.util.Date date)
static java.util.Calendar	asCalendar(long timeInMillis)
static java.util.Calendar	asCalendar(java.lang.String calendar)
static java.util.Calendar	asCalendar(java.lang.String calendar, java.lang.String format)
static java.util.Calendar	asCalendar(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	asDate(java.util.Calendar c)
static java.sql.Date	asDate(java.util.Date date)
static java.sql.Date	asDate(long timeInMillis)
static java.sql.Date	asDate(java.lang.String date)
static java.sql.Date	asDate(java.lang.String date, java.lang.String format)
static java.sql.Date	asDate(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	asGregorianCalendar(java.util.Calendar c)
static java.util.GregorianCalendar	asGregorianCalendar(java.util.Date date)
static java.util.GregorianCalendar	asGregorianCalendar(long timeInMillis)
static java.util.GregorianCalendar	asGregorianCalendar(java.lang.String calendar)
static java.util.GregorianCalendar	asGregorianCalendar(java.lang.String calendar, java.lang.String format)
static java.util.GregorianCalendar	asGregorianCalendar(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	asJUDate(java.util.Calendar c)
static java.util.Date	asJUDate(java.util.Date date)
static java.util.Date	asJUDate(long timeInMillis)
static java.util.Date	asJUDate(java.lang.String date)
static java.util.Date	asJUDate(java.lang.String date, java.lang.String format)
static java.util.Date	asJUDate(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	asTime(java.util.Calendar c)
static java.sql.Time	asTime(java.util.Date date)
static java.sql.Time	asTime(long timeInMillis)
static java.sql.Time	asTime(java.lang.String date)
static java.sql.Time	asTime(java.lang.String date, java.lang.String format)
static java.sql.Time	asTime(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	asTimestamp(java.util.Calendar c)
static java.sql.Timestamp	asTimestamp(java.util.Date date)
static java.sql.Timestamp	asTimestamp(long timeInMillis)
static java.sql.Timestamp	asTimestamp(java.lang.String date)
static java.sql.Timestamp	asTimestamp(java.lang.String date, java.lang.String format)
static java.sql.Timestamp	asTimestamp(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	asXMLGregorianCalendar(java.util.Calendar c)
static javax.xml.datatype.XMLGregorianCalendar	asXMLGregorianCalendar(java.util.Date date)
static javax.xml.datatype.XMLGregorianCalendar	asXMLGregorianCalendar(long timeInMillis)
static javax.xml.datatype.XMLGregorianCalendar	asXMLGregorianCalendar(java.lang.String calendar)
static javax.xml.datatype.XMLGregorianCalendar	asXMLGregorianCalendar(java.lang.String calendar, java.lang.String format)
static javax.xml.datatype.XMLGregorianCalendar	asXMLGregorianCalendar(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 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 long	currentMillis()
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, 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, 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, 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 <T extends java.util.Calendar> T	roll(T c, long amount, CalendarUnit unit) Adds or subtracts the specified amount of time to the given calendar unit, based on the calendar's rules.
static <T extends java.util.Date> T	roll(T date, long amount, CalendarUnit unit) Adds or subtracts the specified amount of time to the given calendar unit, based on the calendar's rules.
static <T extends java.util.Calendar> T	roll(T c, long amount, java.util.concurrent.TimeUnit unit) Adds or subtracts the specified amount of time to the given time unit, based on the calendar's rules.
static <T extends java.util.Date> T	roll(T date, long amount, java.util.concurrent.TimeUnit unit) Adds or subtracts the specified amount of time to the given time unit, based on the calendar's rules.

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

Method Detail

asJUDate

public static java.util.Date asJUDate(java.util.Calendar c)

asJUDate

public static java.util.Date asJUDate(java.util.Date date)

asJUDate

public static java.util.Date asJUDate(long timeInMillis)

asJUDate

public static java.util.Date asJUDate(java.lang.String date)

asJUDate

public static java.util.Date asJUDate(java.lang.String date,
                                      java.lang.String format)

asJUDate

public static java.util.Date asJUDate(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.

asDate

public static java.sql.Date asDate(java.util.Calendar c)

asDate

public static java.sql.Date asDate(java.util.Date date)

asDate

public static java.sql.Date asDate(long timeInMillis)

asDate

public static java.sql.Date asDate(java.lang.String date)

asDate

public static java.sql.Date asDate(java.lang.String date,
                                   java.lang.String format)

asDate

public static java.sql.Date asDate(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:

asTime

public static java.sql.Time asTime(java.util.Calendar c)

asTime

public static java.sql.Time asTime(java.util.Date date)

asTime

public static java.sql.Time asTime(long timeInMillis)

asTime

public static java.sql.Time asTime(java.lang.String date)

asTime

public static java.sql.Time asTime(java.lang.String date,
                                   java.lang.String format)

asTime

public static java.sql.Time asTime(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:

asTimestamp

public static java.sql.Timestamp asTimestamp(java.util.Calendar c)

asTimestamp

public static java.sql.Timestamp asTimestamp(java.util.Date date)

asTimestamp

public static java.sql.Timestamp asTimestamp(long timeInMillis)

asTimestamp

public static java.sql.Timestamp asTimestamp(java.lang.String date)

asTimestamp

public static java.sql.Timestamp asTimestamp(java.lang.String date,
                                             java.lang.String format)

asTimestamp

public static java.sql.Timestamp asTimestamp(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:

asCalendar

public static java.util.Calendar asCalendar(java.util.Calendar c)

asCalendar

public static java.util.Calendar asCalendar(java.util.Date date)

asCalendar

public static java.util.Calendar asCalendar(long timeInMillis)

asCalendar

public static java.util.Calendar asCalendar(java.lang.String calendar)

asCalendar

public static java.util.Calendar asCalendar(java.lang.String calendar,
                                            java.lang.String format)

asCalendar

public static java.util.Calendar asCalendar(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:

asGregorianCalendar

public static java.util.GregorianCalendar asGregorianCalendar(java.util.Calendar c)

asGregorianCalendar

public static java.util.GregorianCalendar asGregorianCalendar(java.util.Date date)

asGregorianCalendar

public static java.util.GregorianCalendar asGregorianCalendar(long timeInMillis)

asGregorianCalendar

public static java.util.GregorianCalendar asGregorianCalendar(java.lang.String calendar)

asGregorianCalendar

public static java.util.GregorianCalendar asGregorianCalendar(java.lang.String calendar,
                                                              java.lang.String format)

asGregorianCalendar

public static java.util.GregorianCalendar asGregorianCalendar(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:

asXMLGregorianCalendar

public static javax.xml.datatype.XMLGregorianCalendar asXMLGregorianCalendar(java.util.Calendar c)

asXMLGregorianCalendar

public static javax.xml.datatype.XMLGregorianCalendar asXMLGregorianCalendar(java.util.Date date)

asXMLGregorianCalendar

public static javax.xml.datatype.XMLGregorianCalendar asXMLGregorianCalendar(long timeInMillis)

asXMLGregorianCalendar

public static javax.xml.datatype.XMLGregorianCalendar asXMLGregorianCalendar(java.lang.String calendar)

asXMLGregorianCalendar

public static javax.xml.datatype.XMLGregorianCalendar asXMLGregorianCalendar(java.lang.String calendar,
                                                                             java.lang.String format)

asXMLGregorianCalendar

public static javax.xml.datatype.XMLGregorianCalendar asXMLGregorianCalendar(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:

currentMillis

public static long currentMillis()

Returns:

See Also:

System.currentTimeMillis()

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()

roll

public static <T extends java.util.Date> T roll(T date,
                                                long amount,
                                                java.util.concurrent.TimeUnit unit)

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

public static <T extends java.util.Date> T roll(T date,
                                                long amount,
                                                CalendarUnit unit)

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

public static <T extends java.util.Calendar> T roll(T c,
                                                    long amount,
                                                    java.util.concurrent.TimeUnit unit)

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:

c -

amount -

unit -

Returns:

a new instance of Calendar with the specified amount rolled.

roll

public static <T extends java.util.Calendar> T roll(T c,
                                                    long amount,
                                                    CalendarUnit unit)

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:

c -

amount -

unit -

Returns:

a new instance of Calendar with the specified amount rolled.

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,
                          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,
                          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,
                          java.util.TimeZone timeZone)