Crate easytime[−][src]

Providing wrapper types for safely performing panic-free checked arithmetic on instants and durations.

This crate provides the following two data structures.

easytime::Instant – A wrapper type for std::time::Instant
easytime::Duration – A wrapper type for std::time::Duration

Examples

use std::time::Duration as StdDuration;

use easytime::{Duration, Instant};

fn foo(secs: u64, nanos: u32, instant: Instant) -> Option<StdDuration> {
    let now = Instant::now();

    let dur = Duration::new(secs, nanos);
    (now - instant - dur).into_inner()
}

If you use std::time directly, you need to write as follows:

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

fn foo(secs: u64, nanos: u32, instant: Instant) -> Option<Duration> {
    let now = Instant::now();

    let secs = Duration::from_secs(secs);
    let nanos = Duration::from_nanos(nanos as u64);

    let dur = secs.checked_add(nanos)?;
    now.checked_duration_since(instant)?.checked_sub(dur)
}

Optional features

std (enabled by default)
- Enable to use easytime::Instant.
- If disabled this feature, easytime can be used in no_std environments.

Structs

Duration	A `Duration` type to represent a span of time, typically used for system timeouts.
Instant	`std` A measurement of a monotonically nondecreasing clock. Opaque and useful only with `Duration`.
TryFromTimeError	The error type returned when a conversion from `easytime` types to `std::time` types fails.