Package nl.vpro.util

Class TimeUtils

java.lang.Object

nl.vpro.util.TimeUtils

public class TimeUtils
extends Object

Since:

0.45

Author:

Michiel Meeuwissen

Field Summary

Fields

Modifier and Type	Field	Description
static final ZonedDateTime	LOCAL_EPOCH
static final Duration	MAX_DURATION
static final ZoneId	ZONE_ID

Constructor Summary

Constructors

Constructor	Description
TimeUtils()

Method Summary

Modifier and Type	Method	Description
static @PolyNull Date	asDate(@PolyNull Duration duration)
static @PolyNull Duration	between(@PolyNull Temporal instant1, @PolyNull Temporal instant2)	null safe version of Duration.between(Temporal, Temporal).
static @PolyNull Duration	durationOf(@PolyNull Duration d)
static Optional<Duration>	durationOf(Integer i)
static Optional<Duration>	durationOf(Date i)
static boolean	isLarger(@Nullable Duration duration1, @Nullable Duration duration2)
static Optional<Instant>	parse(CharSequence dateValue)
static Optional<Duration>	parseDuration(CharSequence d)	Parses a CharSequence to a duration.
static Optional<Duration>	parseDuration(CharSequence d, ZonedDateTime at)
static @PolyNull Duration	parseDurationOrThrow(@PolyNull CharSequence d)
static Optional<LocalDate>	parseLocalDate(CharSequence d)
static Optional<LocalDateTime>	parseLocalDateTime(CharSequence d)
static LocalTime	parseLocalTime(CharSequence t)
static Optional<? extends TemporalAmount>	parseTemporalAmount(@Nullable CharSequence d)	Parses a CharSequence to a TemporalAmount.
static Optional<ZonedDateTime>	parseZoned(CharSequence parse)
static @PolyNull Duration	roundToMillis(@PolyNull Duration duration)	Rounds the duration to the nearest millis (This may round up half a millis).
static Optional<Long>	toMillis(@Nullable Duration d)
static String	toParsableString(Duration duration)
static Optional<Float>	toSeconds(@Nullable Duration d)
static Optional<Integer>	toSecondsInteger(Duration d)
static @PolyNull Instant	truncated(@PolyNull Instant instant)
static @PolyNull Instant	truncatedTo(@PolyNull Instant instant, @Nullable ChronoUnit unit)

Methods inherited from class java.lang.Object

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

Field Details

ZONE_ID

public static final ZoneId ZONE_ID

LOCAL_EPOCH

public static final ZonedDateTime LOCAL_EPOCH

MAX_DURATION

public static final Duration MAX_DURATION

Constructor Details

TimeUtils

public TimeUtils()

Method Details

parseZoned

public static Optional<ZonedDateTime> parseZoned(CharSequence parse)

parse

public static Optional<Instant> parse(CharSequence dateValue)

parseDuration

public static Optional<Duration> parseDuration(CharSequence d)

Parses a CharSequence to a duration. This begins for checking emptyness (and returns then an empty Optional . Then it basically calls Duration.parse(CharSequence), but if that fails it has several fall backs:

• Also a week notation like PT2W as defined by ISO-8601 is supported
• Possible white space breaking the parsing will be ignored
• If the string looks like an unresolved (spring EL) variable, we'll parse to the empty optional
• If the string parses as a Long, it will be interpreted as a number of milliseconds
• If the string would become a valid ISO-8601 duration by prefixing it with 'P' or 'PT', that will be done too, making those prefixes effectively optional, so that the string like '1s' will parse to one second.

See Also:

• parseDuration(CharSequence)

parseDurationOrThrow

public static @PolyNull Duration parseDurationOrThrow(@PolyNull CharSequence d)

Since:

5.0

parseDuration

public static Optional<Duration> parseDuration(CharSequence d,
 ZonedDateTime at)

parseTemporalAmount

public static Optional<? extends TemporalAmount> parseTemporalAmount(@Nullable CharSequence d)

Parses a CharSequence to a TemporalAmount. First using Period.parse(CharSequence), and than, if that fails, using parseDuration(CharSequence)

toParsableString

public static String toParsableString(Duration duration)

parseLocalDateTime

public static Optional<LocalDateTime> parseLocalDateTime(CharSequence d)

Since:

2.6

parseLocalDate

public static Optional<LocalDate> parseLocalDate(CharSequence d)

Since:

4.0

durationOf

public static Optional<Duration> durationOf(Integer i)

durationOf

public static Optional<Duration> durationOf(Date i)

durationOf

public static @PolyNull Duration durationOf(@PolyNull Duration d)

toSecondsInteger

public static Optional<Integer> toSecondsInteger(Duration d)

toSeconds

public static Optional<Float> toSeconds(@Nullable Duration d)

toMillis

public static Optional<Long> toMillis(@Nullable Duration d)

asDate

public static @PolyNull Date asDate(@PolyNull Duration duration)

between

public static @PolyNull Duration between(@PolyNull Temporal instant1,
 @PolyNull Temporal instant2)

null safe version of Duration.between(Temporal, Temporal). If one or both of the arguments are null, the result is null too.

isLarger

public static boolean isLarger(@Nullable Duration duration1,
 @Nullable Duration duration2)

roundToMillis

public static @PolyNull Duration roundToMillis(@PolyNull Duration duration)

Rounds the duration to the nearest millis (This may round up half a millis).

truncatedTo

public static @PolyNull Instant truncatedTo(@PolyNull Instant instant,
 @Nullable ChronoUnit unit)

Since:

2.34

truncated

public static @PolyNull Instant truncated(@PolyNull Instant instant)

Since:

2.34

parseLocalTime

public static LocalTime parseLocalTime(CharSequence t)