Enum TimeResult 

pub enum TimeResult {
    One(Time),
    Two(Time, Time),
    Many(Time),
    DidNotExist(Time, Time),
}

The result of trying to figure out what real-world time matches a given written time

Variants

One(Time)

The written time matches exactly one real-world time

This is the “normal path.”

Two(Time, Time)

The written time matches two real-world times

This happens relatively often, eg. when a timezone goes back in time.

Many(Time)

The written time matches many real-world times

This should happen very rarely, but can theoretically happen, eg. if a backwards leap second happens while a timezone is going back in time then there would be three possible real-world times matching this Time. Given how rare this should be (basically, probably never actually happen until all programs using this crate are long forgotten), in this scenario a single example value is returned.

DidNotExist(Time, Time)

The written time never actually happened

In this case, the two times returned are the one just before the time at which this written time would have been if it existed, and the one just after.

Implementations

impl TimeResult

pub fn any_approximate(self) -> Time

Returns any point in time that matches the given written time

Note that if the written time did not exist, this will return an approximate version of what it would have been if it did actually exist.

Trait Implementations

impl Clone for TimeResult

fn clone(&self) -> TimeResult

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TimeResult

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for TimeResult

fn eq(&self, other: &TimeResult) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for TimeResult

impl StructuralPartialEq for TimeResult