结构体 Instant 

pub struct Instant { /* private fields */ }

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

Instant 在创建时始终保证不小于任何先前已测量的 instant，常用于度量基准性能或计时某个操作所耗时长等任务。

但请注意，instant 不保证是稳定的。换言之，底层时钟的每一跳长度可能并不相同（例如某些秒可能比其他秒更长）。一个 instant 可能会向前跳跃或发生时间膨胀（变慢或变快），但绝不会倒退。

Instant 是不透明类型，只能彼此之间进行比较。没有方法可以从 instant 中获取“秒数”。它仅允许度量两个 instant 之间的时长（或比较两个 instant）。

Instant 结构体的大小可能因目标操作系统不同而有所不同。

Note

此类型是对内部 std 类型的封装，用于对齐 Tokio 时钟以供 now() 调用。这在测试场景下非常有用，因为你可以使用 time::pause() 与 time::advance()。

实现

impl Instant

pub fn now() -> Instant

返回对应“当前”时刻的 instant。

示例

use tokio::time::Instant;

let now = Instant::now();

pub fn from_std(std: Instant) -> Instant

从 std::time::Instant 创建一个 tokio::time::Instant。

pub fn into_std(self) -> Instant

将该值转换为 std::time::Instant。

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

返回从另一 instant 到此 instant 之间所经过的时间，如果另一 instant 晚于此 instant，则返回零时长。

pub fn checked_duration_since(&self, earlier: Instant) -> Option<Duration>

返回从另一 instant 到此 instant 之间所经过的时间，如果另一 instant 晚于此 instant，则返回 None。

示例

use tokio::time::{Duration, Instant, sleep};

let now = Instant::now();
sleep(Duration::new(1, 0)).await;
let new_now = Instant::now();
println!("{:?}", new_now.checked_duration_since(now));
println!("{:?}", now.checked_duration_since(new_now)); // None

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

返回从另一 instant 到此 instant 之间所经过的时间，如果另一 instant 晚于此 instant，则返回零时长。

示例

use tokio::time::{Duration, Instant, sleep};

let now = Instant::now();
sleep(Duration::new(1, 0)).await;
let new_now = Instant::now();
println!("{:?}", new_now.saturating_duration_since(now));
println!("{:?}", now.saturating_duration_since(new_now)); // 0ns
}

pub fn elapsed(&self) -> Duration

返回自此 instant 创建以来所经过的时间，如果此 instant 处于未来，则返回零时长。

示例

use tokio::time::{Duration, Instant, sleep};

let instant = Instant::now();
let three_secs = Duration::from_secs(3);
sleep(three_secs).await;
assert!(instant.elapsed() >= three_secs);

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

如果 t 可以表示为 Instant（即它处于底层数据结构的表示范围内），则返回 Some(t)，其中 t 是时间 self + duration；否则返回 None。

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

如果 t 可以表示为 Instant（即它处于底层数据结构的表示范围内），则返回 Some(t)，其中 t 是时间 self - duration；否则返回 None。

Trait 实现

impl Add<Duration> for Instant

type Output = Instant

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

fn add(self, other: 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, fmt: &mut Formatter<'_>) -> Result

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

impl From<Instant> for Instant

fn from(time: Instant) -> Instant

从输入类型转换为此类型。

impl From<Instant> for Instant

fn from(time: Instant) -> Instant

从输入类型转换为此类型。

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, rhs: 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