Package org.apache.commons.lang3.time

Class DurationUtils

java.lang.Object

org.apache.commons.lang3.time.DurationUtils

public class DurationUtils
extends Object

Utilities for Duration.

Since:

3.12.0

Constructor Summary

Constructors

Constructor	Description
DurationUtils()

Method Summary

Modifier and Type	Method	Description
static <T extends Throwable> void	accept(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 or Duration.ZERO if null.

Methods inherited from class java.lang.Object

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

Constructor Detail

DurationUtils

public DurationUtils()

Method Detail

accept

public static <T extends Throwable> void accept(FailableBiConsumer<Long,Integer,T> consumer,
                                                Duration duration)
                                         throws T extends Throwable

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.

T extends Throwable

getNanosOfMiili

public static int getNanosOfMiili(Duration duration)

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) and Thread.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

public static boolean isPositive(Duration duration)

Tests whether the given Duration is positive (>0).

Parameters:

duration - the value to test

Returns:

whether the given Duration is positive (>0).

toDuration

public static Duration toDuration(long amount,
                                  TimeUnit timeUnit)

Converts an amount and TimeUnit into a Duration.

Parameters:

amount - the amount of the duration, measured in terms of the unit, positive or negative

timeUnit - the unit that the duration is measured in, must have an exact duration, not null

Returns:

a Duration.

toMillisInt

public static int toMillisInt(Duration duration)

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 return Integer.MAX_VALUE.
• If the duration milliseconds are lesser than Integer.MIN_VALUE, then return Integer.MIN_VALUE.

Parameters:

duration - The duration to convert, not null.

Returns:

int milliseconds.

zeroIfNull

public static Duration zeroIfNull(Duration duration)

Returns the given non-null value or Duration.ZERO if null.

Parameters:

duration - The duration to test.

Returns:

The given duration or Duration.ZERO.