Package org.kiwiproject.time

Class KiwiDates

java.lang.Object
org.kiwiproject.time.KiwiDates
public final class KiwiDates extends Object
The original JDK 1.0 Date class leaves, ahem, much to be desired, but there are still (unfortunately) many classes, interfaces, and libraries that use it and probably won't be changed soon or ever. KiwiDate contains some utilities to convert Instant objects to Date objects shifted by some amount of time, for example if you need a Date that is 30 minutes from a given Instant.

If you have a choice, you should always prefer the Java 8 date/time APIs (e.g. Instant, LocalDateTime, ZonedDateTime) in the java.time package over using the legacy Date. But if you need to convert instants to dates, then this will help.

Functionally this is just a Date wrapper for KiwiInstants.

  • Method Details

    • dateFrom

      public static Date dateFrom(Instant instant)
      Return the Date converted from instant.
      Parameters:
      instant - the Instant to convert
      Returns:
      the converted Date
      API Note:
      This is just a simple wrapper around Date.from(Instant) and is mainly here for consistency with the other utilities provided here

    • dateFromInstantOrNull

      public static @Nullable Date dateFromInstantOrNull(@Nullable Instant instant)
      Return the Date converted from instant, or null if instant is null.

      This is a null-safe wrapper around Date.from(Instant), and is useful in situations when you might have a null instant.

      Parameters:
      instant - the Instant to convert, may be null
      Returns:
      the converted Date or null
      API Note:
      This method only exists because Date.from(Instant) throws NullPointerException if its arguments is null.

    • dateFromInstantMinusMinutes

      public static Date dateFromInstantMinusMinutes(Instant instant, long minutes)
      Return the Date that is the given number of minutes before the given instant.
      Parameters:
      instant - the Instant to convert
      minutes - number of minutes to subtract from instant
      Returns:
      the converted Date

    • dateFromInstantMinusHours

      public static Date dateFromInstantMinusHours(Instant instant, long hours)
      Return the Date that is the given number of hours before the given instant.
      Parameters:
      instant - the Instant to convert
      hours - number of hours to subtract from instant
      Returns:
      the converted Date

    • dateFromInstantMinusDays

      public static Date dateFromInstantMinusDays(Instant instant, long days)
      Return the Date that is the given number of days before the given instant.
      Parameters:
      instant - the Instant to convert
      days - number of days to subtract from instant
      Returns:
      the converted Date

    • dateFromInstantMinusMonths

      public static Date dateFromInstantMinusMonths(Instant instant, long months)
      Return the Date that is the given number of months before the given instant.
      Parameters:
      instant - the Instant to convert
      months - number of months to subtract from instant
      Returns:
      the converted Date

    • dateFromInstantMinusYears

      public static Date dateFromInstantMinusYears(Instant instant, long years)
      Return the Date that is the given number of years before the given instant.
      Parameters:
      instant - the Instant to convert
      years - number of years to subtract from instant
      Returns:
      the converted Date

    • dateFromInstantPlusMinutes

      public static Date dateFromInstantPlusMinutes(Instant instant, long minutes)
      Return the Date that is the given number of minutes after the given instant.
      Parameters:
      instant - the Instant to convert
      minutes - number of minutes to add to instant
      Returns:
      the converted Date

    • dateFromInstantPlusHours

      public static Date dateFromInstantPlusHours(Instant instant, long hours)
      Return the Date that is the given number of hours after the given instant.
      Parameters:
      instant - the Instant to convert
      hours - number of hours to add to instant
      Returns:
      the converted Date

    • dateFromInstantPlusDays

      public static Date dateFromInstantPlusDays(Instant instant, long days)
      Return the Date that is the given number of days after the given instant.
      Parameters:
      instant - the Instant to convert
      days - number of days to add to instant
      Returns:
      the converted Date

    • dateFromInstantPlusMonths

      public static Date dateFromInstantPlusMonths(Instant instant, long months)
      Return the Date that is the given number of months after the given instant.
      Parameters:
      instant - the Instant to convert
      months - number of months to add to instant
      Returns:
      the converted Date

    • dateFromInstantPlusYears

      public static Date dateFromInstantPlusYears(Instant instant, long years)
      Return the Date that is the given number of years after the given instant.
      Parameters:
      instant - the Instant to convert
      years - number of years to add to instant
      Returns:
      the converted Date