Class MonotonicClock

java.lang.Object

java.time.Clock

com.eqixiac.equinix.core.internal.MonotonicClock

All Implemented Interfaces:

InstantSource

public final class MonotonicClock
extends Clock

A Clock whose millis() advances with System.nanoTime(): it is monotonic, so a wall-clock adjustment (NTP step, DST, a manual change) can neither shorten nor extend an elapsed-time measurement. It is the default time source of the SDK's elapsed-time logic (for example CircuitBreaker cooldowns); tests substitute a controllable Clock instead of sleeping.

The instant it reports is anchored to the wall clock once, at class initialisation, so it is only meaningful for measuring durations, not as a calendar time.

Author:

ianjones

Method Summary

Modifier and Type	Method	Description
static Clock	get()	Returns the shared monotonic clock.
ZoneId	getZone()
Instant	instant()
long	millis()
Clock	withZone(ZoneId zone)	Only UTC is supported: the clock exists to measure durations, where a zone is meaningless.

Methods inherited from class Clock

equals, fixed, hashCode, offset, system, systemDefaultZone, systemUTC, tick, tickMillis, tickMinutes, tickSeconds

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Method Details

get

public static Clock get()

Returns the shared monotonic clock.

Returns:

the singleton instance

getZone

public ZoneId getZone()

Specified by:

getZone in class Clock

withZone

public Clock withZone(ZoneId zone)

Only UTC is supported: the clock exists to measure durations, where a zone is meaningless.

Specified by:

withZone in interface InstantSource

Specified by:

withZone in class Clock

Throws:

UnsupportedOperationException - for any zone other than UTC

millis

public long millis()

Specified by:

millis in interface InstantSource

Overrides:

millis in class Clock

instant

public Instant instant()

Specified by:

instant in interface InstantSource

Specified by:

instant in class Clock