Struct WorldClock 

pub struct WorldClock {
    pub tick: WorldTick,
    pub epoch: DateTime<Utc>,
    pub wall_time: DateTime<Utc>,
    pub hz: f64,
    pub time_scale: f64,
}

World clock — drives the simulation cadence.

Each call to advance increments the tick counter and updates wall-time. The hz field controls the nominal tick rate, while time_scale allows simulated time to run faster or slower than real time.

Fields

tick: WorldTick

Current tick number.

epoch: DateTime<Utc>

UTC timestamp of tick zero.

wall_time: DateTime<Utc>

Wall-clock time of the most recent tick.

hz: f64

Nominal ticks per second.

time_scale: f64

Multiplier for simulated time (1.0 = real-time).

Implementations

impl WorldClock

pub fn new(hz: f64) -> Self

Create a new clock at tick zero running at the given frequency.

pub fn advance(&mut self)

Advance the clock by one tick, updating wall-time to now.

pub fn elapsed_seconds(&self) -> f64

Real seconds elapsed since epoch.

pub fn simulated_seconds(&self) -> f64

Simulated seconds = ticks / hz * time_scale.

Trait Implementations

impl Clone for WorldClock

fn clone(&self) -> WorldClock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorldClock

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

Formats the value using the given formatter.

impl Default for WorldClock

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for WorldClock

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for WorldClock

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.