结构体 Instant 

pub struct Instant { /* 私有字段 */ }

单调不减时钟的测量值。不透明，仅与 Duration 配合使用时有用。

在创建时，Instant 始终保证不小于任何先前测量的 Instant，并且通常用于测量基准测试或操作耗时之类的任务。

但请注意，Instant 不保证是稳定的。换句话说，底层时钟的每个 tick 长度可能不同（例如，某些秒可能比其他秒长）。Instant 可能会向前跳跃或经历时间膨胀（变慢或变快），但绝不会向后走。

Instant 是不透明类型，只能相互比较。没有方法可以从 Instant 获取"秒数"。相反，它只允许测量两个 Instant 之间的持续时间（或比较两个 Instant）。

Instant 结构体的大小可能因目标操作系统而异。

注意

此类型包装内部的 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

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

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

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

示例

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