Class DurationUtils
java.lang.Object
edu.internet2.middleware.grouperClientExt.org.apache.commons.lang3.time.DurationUtils
Utilities for
Duration
.- Since:
- 3.12.0
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic <T extends Throwable>
voidaccept
(FailableBiConsumer<Long, Integer, T> consumer, Duration duration) Accepts the function with the duration as a long milliseconds and int nanoseconds.static int
getNanosOfMiili
(Duration duration) Gets the nanosecond part of a Duration converted to milliseconds.static boolean
isPositive
(Duration duration) Tests whether the given Duration is positive (>0).static Duration
toDuration
(long amount, TimeUnit timeUnit) Converts an amount and TimeUnit into a Duration.static int
toMillisInt
(Duration duration) Converts a Duration to milliseconds bound to an int (instead of a long).static Duration
zeroIfNull
(Duration duration) Returns the given non-null value orDuration.ZERO
if null.
-
Constructor Details
-
DurationUtils
public DurationUtils()
-
-
Method Details
-
accept
public static <T extends Throwable> void accept(FailableBiConsumer<Long, Integer, throws TT> consumer, Duration duration) Accepts the function with the duration as a long milliseconds and int nanoseconds.- Type Parameters:
T
- The function exception.- Parameters:
consumer
- Accepting function.duration
- The duration to pick apart.- Throws:
T
- See the function signature.
-
getNanosOfMiili
Gets the nanosecond part of a Duration converted to milliseconds.Handy when calling an API that takes a long of milliseconds and an int of nanoseconds. For example,
Object.wait(long, int)
andThread.sleep(long, int)
.Note that is this different from
Duration.getNano()
because a duration are seconds and nanoseconds.- Parameters:
duration
- The duration to query.- Returns:
- nanoseconds between 0 and 999,999.
-
isPositive
Tests whether the given Duration is positive (>0).- Parameters:
duration
- the value to test- Returns:
- whether the given Duration is positive (>0).
-
toDuration
Converts an amount and TimeUnit into a Duration.- Parameters:
amount
- the amount of the duration, measured in terms of the unit, positive or negativetimeUnit
- the unit that the duration is measured in, must have an exact duration, not null- Returns:
- a Duration.
-
toMillisInt
Converts a Duration to milliseconds bound to an int (instead of a long).Handy for low-level APIs that take millisecond timeouts in ints rather than longs.
- If the duration milliseconds are greater than
Integer.MAX_VALUE
, then returnInteger.MAX_VALUE
. - If the duration milliseconds are lesser than
Integer.MIN_VALUE
, then returnInteger.MIN_VALUE
.
- Parameters:
duration
- The duration to convert, not null.- Returns:
- int milliseconds.
- If the duration milliseconds are greater than
-
zeroIfNull
Returns the given non-null value orDuration.ZERO
if null.- Parameters:
duration
- The duration to test.- Returns:
- The given duration or
Duration.ZERO
.
-