com.edorasware.api.time

Class TimeUtils

java.lang.Object

com.edorasware.api.time.TimeUtils

public class TimeUtils
extends Object

Provides utility methods related to dates / times.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ISO_8601_DATE_FORMAT Defines the default string format for dates.
static String	ISO_8601_DATE_TIME_FORMAT Defines the default string format for date/time timestamps.
static int	ISO_8601_DATE_TIME_FORMAT_LENGTH
static ZoneId	UTC The UTC timezone.

Method Summary

Modifier and Type	Method and Description
static Instant	dateToInstant(Date date) Converts a Date value (possibly null) to the equivalent Instant.
static String	formatUtcDate(Instant instant) Formats an instant to a UTC date using the default date pattern ISO_8601_DATE_FORMAT.
static String	formatUtcDateTime(Instant instant) Formats an instant to a UTC date/time using the default date/time pattern ISO_8601_DATE_TIME_FORMAT.
static String	formatUtcDateTime(Instant instant, String pattern) Formats the instant to a UTC date/time using the given pattern.
static Date	instantToDate(Instant instant) Converts an Instant value (possibly null) to the equivalent Date.
static Instant	parseUtcDate(String text) Parses a date string using the default date pattern ISO_8601_DATE_FORMAT.
static Instant	parseUtcDateTime(String text) Parses a date/time string using the default date/time pattern ISO_8601_DATE_TIME_FORMAT.
static Instant	parseUtcDateTime(String text, String pattern) Parses a date/time string using the given pattern.

Methods inherited from class java.lang.Object

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

Field Detail

UTC

public static final ZoneId UTC

The UTC timezone.

ISO_8601_DATE_FORMAT

public static final String ISO_8601_DATE_FORMAT

Defines the default string format for dates.

See Also:

Constant Field Values

ISO_8601_DATE_TIME_FORMAT

public static final String ISO_8601_DATE_TIME_FORMAT

Defines the default string format for date/time timestamps.

See Also:

Constant Field Values

ISO_8601_DATE_TIME_FORMAT_LENGTH

public static final int ISO_8601_DATE_TIME_FORMAT_LENGTH

See Also:

Constant Field Values

Method Detail

formatUtcDate

public static String formatUtcDate(Instant instant)

Formats an instant to a UTC date using the default date pattern ISO_8601_DATE_FORMAT.

Parameters:

instant - the Instant to be formatted

Returns:

the formatted date

Throws:

DateTimeParseException - if the operation failed

parseUtcDate

public static Instant parseUtcDate(String text)

Parses a date string using the default date pattern ISO_8601_DATE_FORMAT.

Parameters:

text - the string to be parsed

Returns:

the parsed Instant

Throws:

DateTimeParseException - if the operation failed

formatUtcDateTime

public static String formatUtcDateTime(Instant instant)

Formats an instant to a UTC date/time using the default date/time pattern ISO_8601_DATE_TIME_FORMAT.

Parameters:

instant - the Instant to be formatted

Returns:

the formatted date/time

formatUtcDateTime

public static String formatUtcDateTime(Instant instant,
                                       String pattern)

Formats the instant to a UTC date/time using the given pattern.

Parameters:

instant - the Instant to be formatted

pattern - the pattern (see DateTimeFormatter.ofPattern(String))

Returns:

the formatted date

Throws:

DateTimeParseException - if the operation failed

parseUtcDateTime

public static Instant parseUtcDateTime(String text)

Parses a date/time string using the default date/time pattern ISO_8601_DATE_TIME_FORMAT.

Parameters:

text - the string to be parsed

Returns:

the parsed instant

Throws:

DateTimeParseException - if the operation failed

IllegalArgumentException - if the input has the wrong length

parseUtcDateTime

public static Instant parseUtcDateTime(String text,
                                       String pattern)

Parses a date/time string using the given pattern.

Parameters:

text - the string to be parsed

Returns:

the parsed Instant

Throws:

DateTimeParseException - if the operation failed

dateToInstant

public static Instant dateToInstant(Date date)

Converts a Date value (possibly null) to the equivalent Instant.

Parameters:

date - the date value

Returns:

the equivalent instant

instantToDate

public static Date instantToDate(Instant instant)

Converts an Instant value (possibly null) to the equivalent Date.

Parameters:

instant - the instant value

Returns:

the equivalent instant