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_manual() -> ClockController

Install a manual clock globally.

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

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

pub fn install_manual_at(start_at: DateTime<Utc>) -> ClockController

Install a manual clock globally starting at a specific time.

See install_manual for details.

pub fn is_manual() -> bool

Check if a manual clock is installed.

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

Get the current manual time, if a manual clock is installed.

Returns:

• None if no clock is initialized (doesn’t initialize one)
• None for realtime clocks
• Some(time) for manual clocks