Enum chrono::offset::LocalResult

source ·
pub enum LocalResult<T> {
    Single(T),
    Ambiguous(T, T),
    None,
}
Expand description

Old name of MappedLocalTime. See that type for more documentation.

Variants§

§

Single(T)

The local time maps to a single unique result.

§

Ambiguous(T, T)

The local time is ambiguous because there is a fold in the local time.

This variant contains the two possible results, in the order (earliest, latest).

§

None

The local time does not exist because there is a gap in the local time.

This variant may also be returned if there was an error while resolving the local time, caused by for example missing time zone data files, an error in an OS API, or overflow.

Implementations§

source§

impl<T> LocalResult<T>

source

pub fn single(self) -> Option<T>

Returns Some if the time zone mapping has a single result.

§Errors

Returns None if local time falls in a fold or gap in the local time, or if there was an error.

source

pub fn earliest(self) -> Option<T>

Returns the earliest possible result of a the time zone mapping.

§Errors

Returns None if local time falls in a gap in the local time, or if there was an error.

source

pub fn latest(self) -> Option<T>

Returns the latest possible result of a the time zone mapping.

§Errors

Returns None if local time falls in a gap in the local time, or if there was an error.

source

pub fn map<U, F: FnMut(T) -> U>(self, f: F) -> MappedLocalTime<U>

Maps a MappedLocalTime<T> into MappedLocalTime<U> with given function.

source§

impl<Tz: TimeZone> LocalResult<Date<Tz>>

source

pub fn and_time(self, time: NaiveTime) -> MappedLocalTime<DateTime<Tz>>

Makes a new DateTime from the current date and given NaiveTime. The offset in the current date is preserved.

Propagates any error. Ambiguous result would be discarded.

source

pub fn and_hms_opt( self, hour: u32, min: u32, sec: u32 ) -> MappedLocalTime<DateTime<Tz>>

Makes a new DateTime from the current date, hour, minute and second. The offset in the current date is preserved.

Propagates any error. Ambiguous result would be discarded.

source

pub fn and_hms_milli_opt( self, hour: u32, min: u32, sec: u32, milli: u32 ) -> MappedLocalTime<DateTime<Tz>>

Makes a new DateTime from the current date, hour, minute, second and millisecond. The millisecond part can exceed 1,000 in order to represent the leap second. The offset in the current date is preserved.

Propagates any error. Ambiguous result would be discarded.

source

pub fn and_hms_micro_opt( self, hour: u32, min: u32, sec: u32, micro: u32 ) -> MappedLocalTime<DateTime<Tz>>

Makes a new DateTime from the current date, hour, minute, second and microsecond. The microsecond part can exceed 1,000,000 in order to represent the leap second. The offset in the current date is preserved.

Propagates any error. Ambiguous result would be discarded.

source

pub fn and_hms_nano_opt( self, hour: u32, min: u32, sec: u32, nano: u32 ) -> MappedLocalTime<DateTime<Tz>>

Makes a new DateTime from the current date, hour, minute, second and nanosecond. The nanosecond part can exceed 1,000,000,000 in order to represent the leap second. The offset in the current date is preserved.

Propagates any error. Ambiguous result would be discarded.

source§

impl<T: Debug> LocalResult<T>

source

pub fn unwrap(self) -> T

Returns a single unique conversion result or panics.

unwrap() is best combined with time zone types where the mapping can never fail like Utc and FixedOffset. Note that for FixedOffset there is a rare case where a resulting DateTime can be out of range.

§Panics

Panics if the local time falls within a fold or a gap in the local time, and on any error that may have been returned by the type implementing TimeZone.

Trait Implementations§

source§

impl<T: Clone> Clone for LocalResult<T>

source§

fn clone(&self) -> LocalResult<T>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<T: Debug> Debug for LocalResult<T>

source§

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

Formats the value using the given formatter. Read more
source§

impl<T: Hash> Hash for LocalResult<T>

source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl<T: PartialEq> PartialEq for LocalResult<T>

source§

fn eq(&self, other: &LocalResult<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<T: Copy> Copy for LocalResult<T>

source§

impl<T: Eq> Eq for LocalResult<T>

source§

impl<T> StructuralPartialEq for LocalResult<T>

Auto Trait Implementations§

§

impl<T> Freeze for LocalResult<T>
where T: Freeze,

§

impl<T> RefUnwindSafe for LocalResult<T>
where T: RefUnwindSafe,

§

impl<T> Send for LocalResult<T>
where T: Send,

§

impl<T> Sync for LocalResult<T>
where T: Sync,

§

impl<T> Unpin for LocalResult<T>
where T: Unpin,

§

impl<T> UnwindSafe for LocalResult<T>
where T: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.