Struct SystemClock 

pub struct SystemClock;

Available on crate feature std only.

Wall-clock time source backed by std::time::SystemTime. Requires the std feature.

Most production deployments want this; it returns nanoseconds since the Unix epoch using the host’s system clock. The host clock is not strictly monotonic — if the operator adjusts time backwards, the next crate::Chain::append will return crate::Error::NonMonotonicClock. Deployments that need a strictly-monotonic source should wrap a monotonic instant in a custom Clock instead.

On the unusual case that SystemTime::now() is before the Unix epoch, this returns Timestamp::EPOCH (0). On the equally-unusual case that the system clock exceeds u64::MAX nanoseconds past the epoch (year ~2554 and later), the value saturates at u64::MAX.

Example

use audit_trail::{Clock, SystemClock};

let clock = SystemClock::new();
let t = clock.now();
assert!(t.as_nanos() > 0);

Implementations

impl SystemClock

pub const fn new() -> Self

Construct a fresh SystemClock.

Trait Implementations

impl Clock for SystemClock

fn now(&self) -> Timestamp

Return the current timestamp.

impl Clone for SystemClock

fn clone(&self) -> SystemClock

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SystemClock

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

Formats the value using the given formatter.

impl Default for SystemClock

fn default() -> SystemClock

Returns the “default value” for a type.

impl Copy for SystemClock