Module com.aoapps.lang

Package com.aoapps.lang.util

Class CalendarUtils

java.lang.Object

com.aoapps.lang.util.CalendarUtils

@Deprecated(forRemoval=false)
public final class CalendarUtils
extends Object

Deprecated.

Please use java.time available since Java SE 8.

Calendar utilities.

Author:

AO Industries, Inc.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	CalendarUtils.DateTimeProducer<T>	Deprecated. Please use java.time available since Java SE 8.

Method Summary

Modifier and Type	Method	Description
static String	formatDate(Calendar cal)	Deprecated. Please use LocalDate.toString() available since Java SE 8.
static void	formatDate(Calendar cal, Appendable out)	Deprecated. Please use LocalDate.toString() available since Java SE 8.
static String	formatDateTime(Calendar cal)	Deprecated. Please use LocalDateTime.format(java.time.format.DateTimeFormatter) available since Java SE 8.
static void	formatDateTime(Calendar cal, Appendable out)	Deprecated. Please use LocalDateTime.format(java.time.format.DateTimeFormatter) available since Java SE 8.
static String	formatTime(Calendar cal)	Deprecated. Please use LocalTime.format(java.time.format.DateTimeFormatter) available since Java SE 8.
static void	formatTime(Calendar cal, Appendable out)	Deprecated. Please use LocalTime.format(java.time.format.DateTimeFormatter) available since Java SE 8.
static GregorianCalendar	getToday()	Deprecated. Please use LocalDate.now() available since Java SE 8.
static GregorianCalendar	getToday(TimeZone timeZone)	Deprecated. Please use LocalDate.now(java.time.ZoneId) available since Java SE 8.
static GregorianCalendar	parseDate(String yyyy_mm_dd)	Deprecated. Please use LocalDate.parse(java.lang.CharSequence) available since Java SE 8.
static GregorianCalendar	parseDate(String yyyy_mm_dd, TimeZone timeZone)	Deprecated. Please use LocalDate.parse(java.lang.CharSequence) available since Java SE 8.
static GregorianCalendar	parseDateTime(String dateTime)	Deprecated. Please use LocalDateTime.parse(java.lang.CharSequence, java.time.format.DateTimeFormatter) available since Java SE 8.
static GregorianCalendar	parseDateTime(String dateTime, TimeZone timeZone)	Deprecated. Please use LocalDateTime.parse(java.lang.CharSequence, java.time.format.DateTimeFormatter) available since Java SE 8.
static <T> T	parseDateTime(String dateTime, TimeZone timeZone, CalendarUtils.DateTimeProducer<T> producer)	Deprecated. Please use LocalDateTime.parse(java.lang.CharSequence, java.time.format.DateTimeFormatter) available since Java SE 8.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

formatDate

@Deprecated(forRemoval=false)
public static String formatDate(Calendar cal)

Deprecated.

Please use LocalDate.toString() available since Java SE 8.

Formats a date in "YYYY-MM-DD" format.

Returns:

the formatted date or null if the parameter is null

formatDate

@Deprecated(forRemoval=false)
public static void formatDate(Calendar cal,
 Appendable out)
                       throws IOException

Deprecated.

Please use LocalDate.toString() available since Java SE 8.

Formats a date in "YYYY-MM-DD" format.

Throws:

IOException

parseDate

@Deprecated(forRemoval=false)
public static GregorianCalendar parseDate(String yyyy_mm_dd,
 TimeZone timeZone)
                                   throws IllegalArgumentException

Deprecated.

Please use LocalDate.parse(java.lang.CharSequence) available since Java SE 8.

Gets the date from the "YYYY-MM-DD" format in the given time zone or null if the parameter is null. Allows negative years like "-344-01-23". Allows shorter months and days like "1976-1-9".

Parameters:

yyyy_mm_dd - The date in YYYY-MM-DD format.

timeZone - The time zone to use or null to use the default time zone

Throws:

IllegalArgumentException

parseDate

@Deprecated(forRemoval=false)
public static GregorianCalendar parseDate(String yyyy_mm_dd)
                                   throws IllegalArgumentException

Deprecated.

Please use LocalDate.parse(java.lang.CharSequence) available since Java SE 8.

Gets the date from the "YYYY-MM-DD" format in the default time zone or null if the parameter is null. Allows negative years like "-344-01-23". Allows shorter months and days like "1976-1-9".

Parameters:

yyyy_mm_dd - The date in YYYY-MM-DD format.

Throws:

IllegalArgumentException

formatTime

@Deprecated(forRemoval=false)
public static String formatTime(Calendar cal)

Deprecated.

Please use LocalTime.format(java.time.format.DateTimeFormatter) available since Java SE 8.

Formats a time in "HH:MM:SS" format.

Returns:

the formatted time or null if the parameter is null

formatTime

@Deprecated(forRemoval=false)
public static void formatTime(Calendar cal,
 Appendable out)
                       throws IOException

Deprecated.

Please use LocalTime.format(java.time.format.DateTimeFormatter) available since Java SE 8.

Formats a time in "HH:MM:SS" format.

Throws:

IOException

formatDateTime

@Deprecated(forRemoval=false)
public static String formatDateTime(Calendar cal)

Deprecated.

Please use LocalDateTime.format(java.time.format.DateTimeFormatter) available since Java SE 8.

Formats a date and time in "YYYY-MM-DD HH:MM:SS" format.

Returns:

the formatted date and time or null if the parameter is null

formatDateTime

@Deprecated(forRemoval=false)
public static void formatDateTime(Calendar cal,
 Appendable out)
                           throws IOException

Deprecated.

Please use LocalDateTime.format(java.time.format.DateTimeFormatter) available since Java SE 8.

Formats a date and time in "YYYY-MM-DD HH:MM:SS" format.

Throws:

IOException

parseDateTime

@Deprecated(forRemoval=false)
public static <T> T parseDateTime(String dateTime,
 TimeZone timeZone,
 CalendarUtils.DateTimeProducer<T> producer)
                           throws IllegalArgumentException

Deprecated.

Please use LocalDateTime.parse(java.lang.CharSequence, java.time.format.DateTimeFormatter) available since Java SE 8.

Gets the date and time from the "YYYY-MM-DD[ HH:MM[:SS[.nnnnnnnnn]]]" format in the given time zone or null if the parameter is null. Allows negative years like "-344-01-23". Allows shorter months, days, hours, minutes, and millis like "1976-1-9 1:2:3.1".

Parameters:

timeZone - The time zone to use or null to use the default time zone

Throws:

IllegalArgumentException

parseDateTime

@Deprecated(forRemoval=false)
public static GregorianCalendar parseDateTime(String dateTime,
 TimeZone timeZone)
                                       throws IllegalArgumentException

Deprecated.

Please use LocalDateTime.parse(java.lang.CharSequence, java.time.format.DateTimeFormatter) available since Java SE 8.

Gets the date and time from the "YYYY-MM-DD[ HH:MM[:SS[.mmm]]]" format in the given time zone or null if the parameter is null. Allows negative years like "-344-01-23". Allows shorter months, days, hours, minutes, and millis like "1976-1-9 1:2:3.1".

Parameters:

timeZone - The time zone to use or null to use the default time zone

Throws:

IllegalArgumentException

parseDateTime

@Deprecated(forRemoval=false)
public static GregorianCalendar parseDateTime(String dateTime)
                                       throws IllegalArgumentException

Deprecated.

Please use LocalDateTime.parse(java.lang.CharSequence, java.time.format.DateTimeFormatter) available since Java SE 8.

Gets the date and time from the "YYYY-MM-DD[ HH:MM[:SS[.mmm]]]" format in the default time zone or null if the parameter is null. Allows negative years like "-344-01-23". Allows shorter months, days, hours, minutes, and millis like "1976-1-9 1:2:3.1".

Throws:

IllegalArgumentException

getToday

@Deprecated(forRemoval=false)
public static GregorianCalendar getToday(TimeZone timeZone)

Deprecated.

Please use LocalDate.now(java.time.ZoneId) available since Java SE 8.

Gets today's date in the given time zone. Hour, minute, second, and millisecond are all set to zero.

Parameters:

timeZone - The time zone to use or null to use the default time zone

getToday

@Deprecated(forRemoval=false)
public static GregorianCalendar getToday()

Deprecated.

Please use LocalDate.now() available since Java SE 8.

Gets today's date in the default time zone. Hour, minute, second, and millisecond are all set to zero.