impl Instant

fn now() -> Instant

Returns an instant corresponding to "now".

Examples

use tokio::time::Instant;

let now = Instant::now();

fn from_std(std: Instant) -> Instant

Create a tokio::time::Instant from a std::time::Instant.

fn into_std(self) -> Instant

Convert the value into a std::time::Instant.

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

Returns the amount of time elapsed from another instant to this one, or zero duration if that instant is later than this one.

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

Returns the amount of time elapsed from another instant to this one, or None if that instant is later than this one.

Examples

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

# #[tokio::main(flavor = "current_thread")]
# async fn main() {
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
# }

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

Returns the amount of time elapsed from another instant to this one, or zero duration if that instant is later than this one.

Examples

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

# #[tokio::main(flavor = "current_thread")]
# async fn main() {
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
}

fn elapsed(&self) -> Duration

Returns the amount of time elapsed since this instant was created, or zero duration if this instant is in the future.

Examples

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

# #[tokio::main(flavor = "current_thread")]
# async fn main() {
let instant = Instant::now();
let three_secs = Duration::from_secs(3);
sleep(three_secs).await;
assert!(instant.elapsed() >= three_secs);
# }

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

Returns Some(t) where t is the time self + duration if t can be represented as Instant (which means it's inside the bounds of the underlying data structure), None otherwise.

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

Returns Some(t) where t is the time self - duration if t can be represented as Instant (which means it's inside the bounds of the underlying data structure), None otherwise.