org.modeshape.common.util

Class DateTimeUtil

java.lang.Object

org.modeshape.common.util.DateTimeUtil

public final class DateTimeUtil
extends Object

Utility for interacting with various date and time objects.

Author:

Horia Chiorean (hchiorea@redhat.com)

Field Summary

Fields

Modifier and Type	Field and Description
static ZoneId	UTC UTC zone id

Method Summary

Modifier and Type	Method and Description
static String	jodaFormat(ZonedDateTime dateTime) Returns the ISO8601 string of a given date-time instance with timezone information, trying to be as closed as possible to what the JODA date-time library would return.
static ZonedDateTime	jodaParse(String iso8601) Creates a ZonedDateTime instance based on the given pattern in ISO 8601 format, compatible with the Joda date-time library.
static LocalDateTime	localDateTimeUTC(long millis) Creates a new UTC LocalDateTime instance based on the given millis value

Methods inherited from class java.lang.Object

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

Field Detail

UTC

public static final ZoneId UTC

UTC zone id

Method Detail

jodaParse

public static ZonedDateTime jodaParse(String iso8601)
                               throws DateTimeParseException

Creates a ZonedDateTime instance based on the given pattern in ISO 8601 format, compatible with the Joda date-time library.

Note that there is no direct correspondence between the JODA-style dates and the new JDK 8 date, especially when it comes to handling milliseconds.

Parameters:

iso8601 - a String representing a date and/or time pattern, may not be null

Returns:

a ZonedDateTime instance, never null

Throws:

DateTimeParseException - if the given pattern cannot be parsed

jodaFormat

public static String jodaFormat(ZonedDateTime dateTime)

Returns the ISO8601 string of a given date-time instance with timezone information, trying to be as closed as possible to what the JODA date-time library would return.

Parameters:

dateTime - a ZonedDateTime instance, may not be null

Returns:

a String representation of the date instance according to the ISO8601 standard

localDateTimeUTC

public static LocalDateTime localDateTimeUTC(long millis)

Creates a new UTC LocalDateTime instance based on the given millis value

Parameters:

millis - a positive amount of millis

Returns:

a LocalDateTime instance.