de.jakop.lotus.domingo.util

Class DateUtil

java.lang.Object

de.jakop.lotus.domingo.util.DateUtil

public final class DateUtil
extends Object

Static utility methods for date operations and conversions.

Author:

Kurt Riede

Field Summary

Fields

Modifier and Type	Field and Description
static String	DATE_FORMAT Date format used for parsing.
static String	DATE_TIME_FORMAT Date/time format used for parsing.
static String	TIME_FORMAT Time format used for parsing.

Method Summary

Modifier and Type	Method and Description
static String	getDateString(Calendar calendar) Formats the date of a Calendar instance to a String.
static String	getDateString(Calendar calendar, Locale locale) Formats the date of a Calendar instance to a String.
static String	getDateTimeString(Calendar calendar) Formats the date and time time of a Calendar instance to a String.
static String	getDateTimeString(Calendar date, Calendar time) Formats the date and time time of a Calendar instance to a String.
static String	getDateTimeString(Calendar date, Calendar time, Locale locale) Formats the date and time time of a Calendar instance to a String.
static String	getDateTimeString(Calendar calendar, Locale locale) Formats the date and time time of a Calendar instance to a String.
static String	getTimeString(Calendar calendar) Formats the time of a Calendar instance to a String.
static String	getTimeString(Calendar calendar, Locale locale) Formats the time of a Calendar instance to a String.
static Calendar	parseDate(String date, boolean adjustToLocalTimeZone) Parses a date given as a string.

Methods inherited from class java.lang.Object

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

Field Detail

DATE_FORMAT

public static final String DATE_FORMAT

Date format used for parsing. The format it compatible with the format of class java.text.SimpleDateFormat.

See Also:

Constant Field Values

TIME_FORMAT

public static final String TIME_FORMAT

Time format used for parsing. The format it compatible with the format of class java.text.SimpleDateFormat.

See Also:

Constant Field Values

DATE_TIME_FORMAT

public static final String DATE_TIME_FORMAT

Date/time format used for parsing. The format it compatible with the format of class java.text.SimpleDateFormat.

See Also:

Constant Field Values

Method Detail

parseDate

public static Calendar parseDate(String date,
                                 boolean adjustToLocalTimeZone)
                          throws IndexOutOfBoundsException,
                                 NumberFormatException

Parses a date given as a string. The format of the resulting string is DATE_TIME_FORMAT.

Parameters:

date - a date formatted as a string

adjustToLocalTimeZone - if result should be adjusted to local time zone or not

Returns:

the date as a java.util.Calendar or null if argument string is null or empty

Throws:

IndexOutOfBoundsException - if the String is too short

NumberFormatException - if a date/time component is out of range or cannot be parsed

getDateTimeString

public static String getDateTimeString(Calendar date,
                                       Calendar time)

Formats the date and time time of a Calendar instance to a String. The format of the resulting string is the short date/time format of the default locale.

Parameters:

date - the date as a java.util.Calendar

time - the time as a java.util.Calendar

Returns:

date as a formatted string

getDateTimeString

public static String getDateTimeString(Calendar date,
                                       Calendar time,
                                       Locale locale)

Formats the date and time time of a Calendar instance to a String. The format of the resulting string is the short date/time format of the given locale.

Parameters:

date - the date as a java.util.Calendar

time - the time as a java.util.Calendar

locale - locale

Returns:

date as a formatted string

getDateTimeString

public static String getDateTimeString(Calendar calendar)

Formats the date and time time of a Calendar instance to a String. The format of the resulting string is the short date/time format of the default locale.

Parameters:

calendar - the date as a java.util.Calendar

Returns:

date as a formatted string

getDateTimeString

public static String getDateTimeString(Calendar calendar,
                                       Locale locale)

Formats the date and time time of a Calendar instance to a String. The format of the resulting string is the short date/time format of the given locale.

Parameters:

calendar - the date as a java.util.Calendar

locale - locale

Returns:

date as a formatted string

getDateString

public static String getDateString(Calendar calendar)

Formats the date of a Calendar instance to a String. The format of the resulting string is the short date/time format of the defaultlocale.

Parameters:

calendar - the date as a java.util.Calendar

Returns:

date as a formatted string

getDateString

public static String getDateString(Calendar calendar,
                                   Locale locale)

Formats the date of a Calendar instance to a String. The format of the resulting string is the short date/time format of the given locale.

Parameters:

calendar - the date as a java.util.Calendar

locale - locale

Returns:

date as a formatted string

getTimeString

public static String getTimeString(Calendar calendar)

Formats the time of a Calendar instance to a String. The format of the resulting string is the short time format of the default locale.

Parameters:

calendar - the date as a java.util.Calendar

Returns:

date as a formatted string

getTimeString

public static String getTimeString(Calendar calendar,
                                   Locale locale)

Formats the time of a Calendar instance to a String. The format of the resulting string is the short time format of the given locale.

Parameters:

calendar - the date as a java.util.Calendar

locale - locale

Returns:

date as a formatted string