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 and Description
DurationUtils()

Method Summary

Modifier and Type	Method and 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

clone, equals, finalize, 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.