Struct RealtimeClock 

pub struct RealtimeClock { /* private fields */ }

A monotonic realtime clock that ensures timestamps always move forward.

Wraps SystemTime but guarantees each now() call returns a timestamp strictly greater than all previous calls, even if the system clock jumps backwards. When the clock goes backwards, it increments from the last seen timestamp by one microsecond.

Implementations

impl RealtimeClock

pub fn new() -> Self

Create a new realtime clock initialized with the current system time.

pub fn with_initial(initial: Microseconds) -> Self

Create a realtime clock initialized with a specific timestamp.

Useful for resuming from a persisted state (e.g., last journal entry).

pub fn now(&self) -> Microseconds

Get the current monotonic timestamp in microseconds since Unix epoch.

Returns system time if it moved forward, otherwise returns last seen + 1µs.

pub fn observe(&self, candidate: Microseconds) -> Microseconds

Observe an external timestamp and return a monotonic realtime value.

If the provided value is not strictly greater than the last seen timestamp, returns last_seen + 1us to preserve strict monotonicity.

pub fn last_seen(&self) -> Microseconds

Get the last seen timestamp without advancing the clock.

Trait Implementations

impl Debug for RealtimeClock

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RealtimeClock

fn default() -> Self

Returns the “default value” for a type.