Package org.kiwiproject.time

Class KiwiDateTimeConverters

java.lang.Object

org.kiwiproject.time.KiwiDateTimeConverters

public class KiwiDateTimeConverters
extends Object

A collection of small utility methods to convert between legacy Date and the Java 8 date/time API classes.

Mainly, these utilities save you some typing and having to remember the chains of method calls you need to make when doing these conversions.

All methods throw IllegalArgumentException if null values are passed into them.

Implementation Note:

Date, according to its JavaDoc, is "intended to reflect coordinated universal time (UTC)" though "it may not do so exactly". The utilities in this class convert arguments to to UTC before converting to Date in order to reflect that intention.

Constructor Summary

Constructors

Constructor	Description
KiwiDateTimeConverters()

Method Summary

Modifier and Type	Method	Description
static Date	toDate(LocalDate localDate)	Convert the given LocalDate into its equivalent Date (epoch milliseconds using UTC).
static Date	toDate(LocalDateTime localDateTime)	Convert the given LocalDateTime into its equivalent Date (epoch milliseconds using UTC).
static Date	toDate(ZonedDateTime zonedDateTime)	Convert the given ZonedDateTime into its equivalent Date (epoch milliseconds using UTC).
static LocalDate	toLocalDate(Date date, ZoneId zoneId)	Convert the given Date into its equivalent LocalDate in the specified time zone.
static LocalDateTime	toLocalDateTime(Date date, ZoneId zoneId)	Convert the given Date into its equivalent LocalDateTime in the specified time zone.
static LocalDateTime	toLocalDateTimeUTC(Date date)	Convert the given Date into its equivalent LocalDateTime in the UTC time zone.
static LocalDate	toLocalDateUTC(Date date)	Convert the given Date into its equivalent LocalDate in the UTC time zone.
static ZonedDateTime	toZonedDateTime(Date date, ZoneId zoneId)	Convert the given Date into its equivalent ZonedDateTime in the specified time zone.
static ZonedDateTime	toZonedDateTimeUTC(Date date)	Convert the given Date into its equivalent ZonedDateTime in the UTC time zone.

Methods inherited from class java.lang.Object

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

Constructor Detail

KiwiDateTimeConverters

public KiwiDateTimeConverters()

Method Detail

toDate

public static Date toDate(LocalDate localDate)

Convert the given LocalDate into its equivalent Date (epoch milliseconds using UTC). The time will be set to the start of the day.

Parameters:

localDate - the LocalDate to convert

Returns:

the converted Date

toDate

public static Date toDate(LocalDateTime localDateTime)

Convert the given LocalDateTime into its equivalent Date (epoch milliseconds using UTC).

Parameters:

localDateTime - the LocalDateTime to convert

Returns:

the converted Date

toDate

public static Date toDate(ZonedDateTime zonedDateTime)

Convert the given ZonedDateTime into its equivalent Date (epoch milliseconds using UTC).

Parameters:

zonedDateTime - the ZonedDateTime to convert

Returns:

the converted Date

toLocalDateUTC

public static LocalDate toLocalDateUTC(Date date)

Convert the given Date into its equivalent LocalDate in the UTC time zone.

Parameters:

date - the Date to convert

Returns:

the converted LocalDate

toLocalDate

public static LocalDate toLocalDate(Date date,
                                    ZoneId zoneId)

Convert the given Date into its equivalent LocalDate in the specified time zone.

Parameters:

date - the Date to convert

zoneId - the time zone as a ZoneId

Returns:

the converted LocalDate

toLocalDateTimeUTC

public static LocalDateTime toLocalDateTimeUTC(Date date)

Convert the given Date into its equivalent LocalDateTime in the UTC time zone.

Parameters:

date - the Date to convert

Returns:

the converted LocalDateTime

See Also:

ZoneOffset.UTC

toLocalDateTime

public static LocalDateTime toLocalDateTime(Date date,
                                            ZoneId zoneId)

Convert the given Date into its equivalent LocalDateTime in the specified time zone.

Parameters:

date - the Date to convert

zoneId - the time zone as a ZoneId

Returns:

the converted LocalDateTime

toZonedDateTimeUTC

public static ZonedDateTime toZonedDateTimeUTC(Date date)

Convert the given Date into its equivalent ZonedDateTime in the UTC time zone.

Parameters:

date - the Date to convert

Returns:

the converted ZonedDateTime

See Also:

ZoneOffset.UTC

toZonedDateTime

public static ZonedDateTime toZonedDateTime(Date date,
                                            ZoneId zoneId)

Convert the given Date into its equivalent ZonedDateTime in the specified time zone.

Parameters:

date - the Date to convert

zoneId - the time zone as a ZoneId

Returns:

the converted ZonedDateTime