Метод saturating_duration_since

Метод saturating_duration_since класса Instant возвращает продолжительность Duration, прошедшую от указанного момента времени до текущего. Если переданный момент наступил позже текущего, метод возвращает нулевую продолжительность Duration::ZERO вместо паники или ошибки. Параметром метод принимает другой момент времени Instant, от которого нужно отсчитать продолжительность.

Синтаксис

instant.saturating_duration_since(earlier)

Пример

Давайте измерим продолжительность между двумя моментами времени, где первый момент наступил раньше второго:

use std::time::{Duration, Instant};

fn main()
{
	let earlier = Instant::now();
	let later = earlier + Duration::from_secs(3);
	
	let res = later.saturating_duration_since(earlier);
	println!("{:?}", res);
}

Результат выполнения кода:

3s

Пример

Давайте проверим поведение метода, когда переданный момент времени наступил позже текущего:

use std::time::{Duration, Instant};

fn main()
{
	let earlier = Instant::now();
	let later = earlier + Duration::from_secs(5);
	
	let res = earlier.saturating_duration_since(later);
	println!("{:?}", res);
}

Результат выполнения кода:

0ns

Смотрите также

метод duration_since,
который возвращает продолжительность между двумя моментами времени
метод checked_duration_since,
который возвращает продолжительность или None, если момент наступил позже
метод elapsed,
который возвращает время, прошедшее с момента создания Instant
метод now,
который возвращает текущий момент времени