Package de.lehmannet.om.util

Class DateConverter

java.lang.Object

de.lehmannet.om.util.DateConverter

public class DateConverter
extends Object

The DateConverter is a helper class that provides methods for handling the all kind of date formats.
E.g. the ISO8601 date format (A short summary about the ISO8601 date format can be accessed at the W3C.), or the Julian date.

Since:

1.0

Author:

doergn@users.sourceforge.net

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	DATE_DELIMITER
private static final String	DATETIME_DELIMITER
private static final String	TIME_DELIMITER
private static final String	UTC_TIMEZONE_OFFSET

Constructor Summary

Constructors

Constructor	Description
DateConverter()

Method Summary

Modifier and Type	Method	Description
private static TimeZone	createTimezone(String timeZone)
private static String	cutLeadingZeroAndPlus(String value)
private static String	formatTimezone(int min)
static String	setLeadingZero(double value)
static String	setLeadingZero(int value)
static Calendar	toDate(String iso8601)	Converts a String object that contains a ISO8601 conform value to an java.util.Calendar object.
static Calendar	toGregorianDate(double julianDate)	Converts a julian date into a gregorian date.
static Calendar	toGregorianDate(double julianDate, TimeZone zone)	Converts a julian date into a gregorian date.
static String	toISO8601(Calendar calendar)	Converts a Date object into a String object that represents a ISO8601 conform string.
static double	toJulianDate(Calendar gregorianCalendar)	Converts a gregorian date into a julian date.

Methods inherited from class java.lang.Object

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

Field Details

DATE_DELIMITER

private static final String DATE_DELIMITER

See Also:

• Constant Field Values

TIME_DELIMITER

private static final String TIME_DELIMITER

See Also:

• Constant Field Values

DATETIME_DELIMITER

private static final String DATETIME_DELIMITER

See Also:

• Constant Field Values

UTC_TIMEZONE_OFFSET

private static final String UTC_TIMEZONE_OFFSET

See Also:

• Constant Field Values

Constructor Details

DateConverter

public DateConverter()

Method Details

toJulianDate

public static double toJulianDate(Calendar gregorianCalendar)

Converts a gregorian date into a julian date.

Parameters:

gregorianDate - The gregorianDate date

Returns:

A julian date with seconds accuracy

toGregorianDate

public static Calendar toGregorianDate(double julianDate)

Converts a julian date into a gregorian date.

Parameters:

julianDate - The julian date

Returns:

A gregorian date with seconds accuracy (Timezone = GMT)

toGregorianDate

public static Calendar toGregorianDate(double julianDate,
 TimeZone zone)

Converts a julian date into a gregorian date.

Parameters:

julianDate - The julian date

zone - The timzone for the returned gregorian date (if NULL is passed GMT will be taken)

Returns:

A gregorian date

toISO8601

public static String toISO8601(Calendar calendar)

Converts a Date object into a String object that represents a ISO8601 conform string.

Parameters:

calendar - A java.util.Date object that has to be converted

Returns:

A ISO8601 conform String, or null if the given date was null

toDate

public static Calendar toDate(String iso8601)
                       throws NumberFormatException

Converts a String object that contains a ISO8601 conform value to an java.util.Calendar object.

Parameters:

iso8601 - A String with a ISO8601 conform value

Returns:

The parameters date as java.util.Calendar, or null if the given string was null or empty.

Throws:

NumberFormatException - if given ISO8601 is malformed.

createTimezone

private static TimeZone createTimezone(String timeZone)
                                throws NumberFormatException

Throws:

NumberFormatException

setLeadingZero

public static String setLeadingZero(int value)

setLeadingZero

public static String setLeadingZero(double value)

cutLeadingZeroAndPlus

private static String cutLeadingZeroAndPlus(String value)

formatTimezone

private static String formatTimezone(int min)