Struct Clock 

pub struct Clock;

Global clock access - like Utc::now() but testable.

Implementations

impl Clock

pub fn now() -> DateTime<Utc>

Get current time from the global clock.

Lazily initializes to realtime if not already set.

pub fn today() -> NaiveDate

Get the current date (without time component).

Lazily initializes to realtime if not already set.

pub fn sleep(duration: Duration) -> ClockSleep

Sleep using the global clock.

pub fn timeout<F: Future>(duration: Duration, future: F) -> ClockTimeout<F>

Timeout using the global clock.

pub fn handle() -> &'static ClockHandle

Get a reference to the global clock handle.

pub fn install_artificial(config: ArtificialClockConfig) -> ClockController

Install an artificial clock globally.

• If not initialized: installs artificial clock, returns controller
• If already artificial: returns existing controller (idempotent)
• If already realtime: panics

Must be called before any Clock::now() calls if you want artificial time.

pub fn is_artificial() -> bool

Check if an artificial clock is installed.

pub fn artificial_now() -> Option<DateTime<Utc>>

Get the current artificial time, if an artificial clock is installed and hasn’t transitioned to realtime.

Returns:

• None if no clock is initialized (doesn’t initialize one)
• None for realtime clocks
• None for artificial clocks that have transitioned to realtime
• Some(time) for artificial clocks that are still artificial