com.scvngr.levelup.core.util

Class IsoDateUtils

java.lang.Object

com.scvngr.levelup.core.util.IsoDateUtils

@ThreadSafe
 @LevelUpApi(contract=INTERNAL)
public final class IsoDateUtils
extends Object

Helper utility class to handle date operations.

Method Summary

Modifier and Type	Method and Description
static TimeZone	getTimeZoneUtc() Gets a new instance of TimeZone representing UTC.
static Date	parseIsoDatetime(String datetime) Parses an ISO 8601 timezone-formatted string into a Date in UTC.
static Date	parseIsoDatetime(String datetime, TimeZone timeZone) Parses an ISO 8601 timezone-formatted string into a Date relative to a TimeZone.
static String	toIsoDatetime(Date date) Converts a Date to a ISO 8601 timezone-formatted string in UTC.
static String	toIsoDatetime(Date date, TimeZone timeZone) Converts a Date to a ISO 8601 timezone-formatted string relative to a TimeZone.

Methods inherited from class java.lang.Object

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

Method Detail

getTimeZoneUtc

public static TimeZone getTimeZoneUtc()

Gets a new instance of TimeZone representing UTC.

Returns:

A new instance of TimeZone representing UTC.

parseIsoDatetime

public static Date parseIsoDatetime(String datetime)
                             throws ParseException

Parses an ISO 8601 timezone-formatted string into a Date in UTC.

Parameters:

datetime - An ISO 8601 formatted datetime with timezone.

Returns:

a parsed Date relative to the given TimeZone.

Throws:

ParseException - if there was a problem parsing the date.

parseIsoDatetime

public static Date parseIsoDatetime(String datetime,
                                    TimeZone timeZone)
                             throws ParseException

Parses an ISO 8601 timezone-formatted string into a Date relative to a TimeZone.

Parameters:

datetime - An ISO 8601 formatted datetime with timezone.

timeZone - The relative TimeZone.

Returns:

a parsed Date relative to the given TimeZone.

Throws:

ParseException - if there was a problem parsing the date.

toIsoDatetime

public static String toIsoDatetime(Date date)

Converts a Date to a ISO 8601 timezone-formatted string in UTC.

Parameters:

date - The date to convert.

Returns:

An ISO 8601 formatted datetime relative to the given TimeZone.

toIsoDatetime

public static String toIsoDatetime(Date date,
                                   TimeZone timeZone)

Converts a Date to a ISO 8601 timezone-formatted string relative to a TimeZone.

Parameters:

date - The date to convert.

timeZone - The relative TimeZone.

Returns:

An ISO 8601 formatted datetime relative to the given TimeZone.