net.openhft.chronicle.core.time

Enum PosixTimeProvider

java.lang.Object

java.lang.Enum<PosixTimeProvider>

net.openhft.chronicle.core.time.PosixTimeProvider

All Implemented Interfaces:

Serializable, Comparable<PosixTimeProvider>, TimeProvider

public enum PosixTimeProvider
extends Enum<PosixTimeProvider>
implements TimeProvider

Provides time based on the Posix standard, particularly utilizing native code to access high-resolution time.

This provider interfaces directly with the native method clock_gettime to fetch nanosecond precision wall-clock time on platforms that support it. It is important to note that this time provider relies on native system calls, thus is platform-dependent. It is typically more accurate and has finer resolution than standard Java time providers.

Enum Constant Summary

Enum Constants

Enum Constant and Description
INSTANCE

Method Summary

Modifier and Type	Method and Description
long	currentTimeMicros() Returns the current time in microseconds.
long	currentTimeMillis() Returns the current time in milliseconds using the standard Java system clock.
long	currentTimeNanos() Returns the current time in nanoseconds.
static PosixTimeProvider	valueOf(String name) Returns the enum constant of this type with the specified name.
static PosixTimeProvider[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

INSTANCE

public static final PosixTimeProvider INSTANCE

Method Detail

values

public static PosixTimeProvider[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (PosixTimeProvider c : PosixTimeProvider.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static PosixTimeProvider valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

currentTimeMillis

public long currentTimeMillis()

Returns the current time in milliseconds using the standard Java system clock.

Specified by:

currentTimeMillis in interface TimeProvider

Returns:

the current time in milliseconds since the Unix epoch

currentTimeMicros

public long currentTimeMicros()
                       throws IllegalStateException

Returns the current time in microseconds.

This method provides microsecond precision by dividing the nanosecond value by 1000.

Specified by:

currentTimeMicros in interface TimeProvider

Returns:

the current time in microseconds since the Unix epoch

Throws:

IllegalStateException - if the time cannot be determined or converted

currentTimeNanos

public long currentTimeNanos()

Returns the current time in nanoseconds.

This method directly calls the native clock_gettime function, providing highly precise and accurate nanosecond resolution time. It uses ClockId.CLOCK_REALTIME for fetching the current time.

Specified by:

currentTimeNanos in interface TimeProvider

Returns:

the current time in nanoseconds since the Unix epoch

Throws:

IllegalStateException - if the native call fails