Instants¶

public class org.apache.commons.lang3.time.Instants[source]¶

Works with Instants.

Methods¶

`toEpochMillis(Instant)`	Converts an Instant to milliseconds bound to a `long` without throwing `ArithmeticException`.
`toInstant(Instant)`	Returns the given non-null instant, or `Instant#EPOCH` if null.
`toInstant(Instant, Instant)`	Returns the given non-null instant, or `defaultInstant` if instant is null.
`toMillisSince(Instant)`	Converts an Instant to milliseconds since that Instant bound to a `long` without throwing `ArithmeticException`.

public static long toEpochMillis(Instant instant)[source]¶

Converts an Instant to milliseconds bound to a long without throwing ArithmeticException.

If the duration milliseconds are greater than Long#MAX_VALUE, then return Long#MAX_VALUE.
If the duration milliseconds are lesser than Long#MIN_VALUE, then return Long#MIN_VALUE.
If the instant is null, treat it as Instant#EPOCH.

Parameters:

instant – The instant to convert, not null.

Returns:

long The given Instant in milliseconds.

See also:

public static Instant toInstant(Instant instant)[source]¶

Returns the given non-null instant, or Instant#EPOCH if null.

public static Instant toInstant(Instant instant, Instant defaultInstant)[source]¶

Returns the given non-null instant, or defaultInstant if instant is null.

Parameters:

instant – The instant to test, may be null.
defaultInstant – The default instant to use if the given instant is null, may be null.

Returns:

The given non-null instant, or defaultInstant if null.

public static long toMillisSince(Instant instant)[source]¶

Converts an Instant to milliseconds since that Instant bound to a long without throwing ArithmeticException.

If the duration milliseconds are greater than Long#MAX_VALUE, then return Long#MAX_VALUE.
If the duration milliseconds are lesser than Long#MIN_VALUE, then return Long#MIN_VALUE.
If the instant is null, treat it as Instant#EPOCH.