org.apache.juneau.utils

Class CalendarUtils

java.lang.Object

org.apache.juneau.utils.CalendarUtils

public class CalendarUtils
extends Object

Utility class for converting Calendar and Date objects to common serialized forms.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CalendarUtils.Format Valid conversion formats.

Constructor Summary

Constructors

Constructor and Description
CalendarUtils()

Method Summary

Modifier and Type	Method and Description
static Calendar	parseCalendar(String in, CalendarUtils.Format format, Locale locale, TimeZone timeZone) Converts the specified serialized date back into a Calendar object.
static Date	parseDate(String in, CalendarUtils.Format format, Locale locale, TimeZone timeZone) Converts the specified serialized date back into a Date object.
static String	serialize(Calendar c, CalendarUtils.Format format, Locale locale, TimeZone timeZone) Converts the specified calendar to a string of the specified format.
static String	serialize(Date d, CalendarUtils.Format format, Locale locale, TimeZone timeZone) Converts the specified date to a string of the specified format.

Methods inherited from class java.lang.Object

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

Constructor Detail

CalendarUtils

public CalendarUtils()

Method Detail

serialize

public static final String serialize(Calendar c,
                                     CalendarUtils.Format format,
                                     Locale locale,
                                     TimeZone timeZone)

Converts the specified calendar to a string of the specified format.

Parameters:

c - The calendar to serialize.

format - The date format.

locale - The locale to use. If null, uses Locale.getDefault().

timeZone - The time zone to use. If null, uses TimeZone.getDefault().

Returns:

The serialized date, or null if the calendar was null.

serialize

public static final String serialize(Date d,
                                     CalendarUtils.Format format,
                                     Locale locale,
                                     TimeZone timeZone)

Converts the specified date to a string of the specified format.

Parameters:

format - The date format.

d - The date to serialize.

locale - The locale to use. If null, uses Locale.getDefault().

timeZone - The time zone to use. If null, uses TimeZone.getDefault().

Returns:

The serialized date, or null if the calendar was null.

parseCalendar

public static final Calendar parseCalendar(String in,
                                           CalendarUtils.Format format,
                                           Locale locale,
                                           TimeZone timeZone)
                                    throws ParseException

Converts the specified serialized date back into a Calendar object.

Parameters:

format - The date format.

in - The serialized date.

locale - The locale to use. If null, uses Locale.getDefault().

timeZone - The timezone to assume if input string doesn't contain timezone info. If null, uses TimeZone.getDefault().

Returns:

The date as a Calendar, or null if the input was null or empty.

Throws:

ParseException - Malformed input encountered.

parseDate

public static final Date parseDate(String in,
                                   CalendarUtils.Format format,
                                   Locale locale,
                                   TimeZone timeZone)
                            throws ParseException

Converts the specified serialized date back into a Date object.

Parameters:

format - The date format.

in - The serialized date.

locale - The locale to use. If null, uses Locale.getDefault().

timeZone - The timezone to assume if input string doesn't contain timezone info. If null, uses TimeZone.getDefault().

Returns:

The date as a Date, or null if the input was null or empty.

Throws:

ParseException - Malformed input encountered.