Enum AmbiguousOffset 

pub enum AmbiguousOffset {
    Unambiguous {
        offset: Offset,
    },
    Gap {
        before: Offset,
        after: Offset,
    },
    Fold {
        before: Offset,
        after: Offset,
    },
}

A possibly ambiguous Offset.

One of three possibilities encoded by this type occurs when converting a civil datetime into a specific instant in time. In rare cases, the civil datetime can fall into a gap or a fold, in which case, one of two offsets could be applicable. Or, perhaps, neither. Callers must decide how best to handle these cases.

Variants

Unambiguous

The offset for a particular civil datetime and time zone is unambiguous.

This is the overwhelmingly common case. In general, the only time this case does not occur is when there is a transition to a different time zone (rare) or to/from daylight saving time (occurs for 1 hour twice in year in many geographic locations).

Fields

offset: Offset

The offset from UTC for the corresponding civil datetime given. The offset is determined via the relevant time zone data, and in this case, there is only one possible offset that could be applied to the given civil datetime.

Gap

The offset for a particular civil datetime and time zone is ambiguous because there is a gap.

This most commonly occurs when a civil datetime corresponds to an hour that was “skipped” in a jump to DST (daylight saving time).

Fields

before: Offset

The offset corresponding to the time before a gap.

For example, given a time zone of America/Los_Angeles, the offset for time immediately preceding 2020-03-08T02:00:00 is -08.

after: Offset

The offset corresponding to the later time in a gap.

For example, given a time zone of America/Los_Angeles, the offset for time immediately following 2020-03-08T02:59:59 is -07.

Fold

The offset for a particular civil datetime and time zone is ambiguous because there is a fold.

This most commonly occurs when a civil datetime corresponds to an hour that was “repeated” in a jump to standard time from DST (daylight saving time).

Fields

before: Offset

The offset corresponding to the earlier time in a fold.

For example, given a time zone of America/Los_Angeles, the offset for time on the first 2020-11-01T01:00:00 is -07.

after: Offset

The offset corresponding to the earlier time in a fold.

For example, given a time zone of America/Los_Angeles, the offset for time on the second 2020-11-01T01:00:00 is -08.

Trait Implementations

impl Clone for AmbiguousOffset

fn clone(&self) -> AmbiguousOffset

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AmbiguousOffset

impl Debug for AmbiguousOffset

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

Formats the value using the given formatter.

impl Eq for AmbiguousOffset

impl Format for AmbiguousOffset

where Offset: Format,

fn format(&self, f: Formatter<'_>)

Writes the defmt representation of self to fmt.

impl PartialEq for AmbiguousOffset

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AmbiguousOffset