结构体 Instant 

pub struct Instant(/* private fields */);

单调递增时钟的测量值。 不透明，只能与 Duration 配合使用。

所得的时长是真实时长，不受时钟调整、 闰秒等影响。 若需获取挂钟时间，请改用 Date。

实现

impl Instant

pub fn now() -> Instant

返回对应“现在”的时刻

此函数同时会更新已存储的时刻。

pub fn now_without_cache_update() -> Instant

返回对应“现在”的时刻，且不更新缓存值。

调用后，recent() 仍会返回旧的时刻。

通常应优先使用 now() 而非此函数。

pub fn recent() -> Instant

返回最近一次更新对应的时刻

pub fn update()

更新已存储的时刻

应当频繁调用此函数，例如在事件循环中或使用 Updater 任务。

pub fn duration_since(&self, earlier: Instant) -> Duration

返回从另一时刻到此刻所经过的时间长度

pub fn elapsed_since_recent(&self) -> Duration

返回从该时刻创建到最近一次更新之间所经过的时间长度

pub fn elapsed(&self) -> Duration

返回自该时刻创建以来所经过的时间长度

此函数同时会更新已存储的时刻。

pub const fn as_ticks(&self) -> u64

以“刻度数”形式返回该时刻的表示。

请注意，一个‘刻度’的长度并不保证在不同平台上， 或在不同 coarsetime 版本之间 代表相同的时间长度。

还需注意，由“0”刻度表示的时刻是未定义的， 并不保证在不同平台上或不同 coarsetime 版本之间 代表同一时间。

本 API 主要用于需要将 Instant 的值存储到 AtomicU64 中的场景。

pub const fn from_ticks(ticks: u64) -> Instant

以指定的“刻度数”创建一个 Instant。

请注意，一个‘刻度’的长度并不保证在不同平台上， 或在不同 coarsetime 版本之间 代表相同的时间长度。

还需注意，由“0”刻度表示的时刻是未定义的， 并不保证在不同平台上或不同 coarsetime 版本之间 代表同一时间。

pub const fn saturating_add(self, rhs: Duration) -> Instant

计算一个晚于当前 Instant 一个 Duration 的时刻，溢出时饱和

pub fn checked_add(self, rhs: Duration) -> Option<Instant>

计算一个晚于当前 Instant 一个 Duration 的时刻，溢出时返回 None

pub const fn saturating_sub(self, rhs: Duration) -> Instant

计算一个早于当前 Instant 一个 Duration 的时刻，下溢时饱和

pub fn checked_sub(self, rhs: Duration) -> Option<Instant>

计算一个早于当前 Instant 一个 Duration 的时刻，下溢时返回 None

Trait 实现

impl Add<Duration> for Instant

type Output = Instant

应用 + 运算符后得到的类型。

fn add(self, rhs: Duration) -> Instant

Performs the + operation. 更多信息

impl AddAssign<Duration> for Instant

fn add_assign(&mut self, rhs: Duration)

Performs the += operation. 更多信息

impl Clone for Instant

fn clone(&self) -> Instant

返回值的副本。 更多信息

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

Performs copy-assignment from source. 更多信息

impl Debug for Instant

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

使用给定的格式化器格式化此值。 更多信息

impl Default for Instant

fn default() -> Instant

Returns the “default value” for a type. 更多信息

impl Hash for Instant

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. 更多信息

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. 更多信息

impl Ord for Instant

fn cmp(&self, other: &Instant) -> Ordering

This method returns an Ordering between self and other. 更多信息

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values. 更多信息

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values. 更多信息

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval. 更多信息

impl PartialEq for Instant

fn eq(&self, other: &Instant) -> bool

测试 self 与 other 值是否相等，供 == 运算符使用。

fn ne(&self, other: &Rhs) -> bool

测试 != 运算符。默认实现几乎总是够用，除非有非常充分的理由，否则不应被覆盖。

impl PartialOrd for Instant

fn partial_cmp(&self, other: &Instant) -> Option<Ordering>

若存在，此方法返回 self 与 other 值之间的排序关系。 更多信息

fn lt(&self, other: &Rhs) -> bool

测试小于（针对 self 与 other），供 < 运算符使用。 更多信息

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator. 更多信息

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator. 更多信息

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator. 更多信息

impl Sub<Duration> for Instant

type Output = Instant

应用 - 运算符后得到的类型。

fn sub(self, rhs: Duration) -> Instant

Performs the - operation. 更多信息

impl Sub for Instant

type Output = Duration

应用 - 运算符后得到的类型。

fn sub(self, other: Instant) -> Duration

Performs the - operation. 更多信息

impl SubAssign<Duration> for Instant

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation. 更多信息

impl Copy for Instant

impl Eq for Instant

impl StructuralPartialEq for Instant