Enum chrono::offset::LocalResult

source · [−]

pub enum LocalResult<T> {
    None,
    Single(T),
    Ambiguous(T, T),
}

Expand description

The conversion result from the local time to the timezone-aware datetime types.

Variants

`None`

Given local time representation is invalid. This can occur when, for example, the positive timezone transition.

`Single(T)`

Given local time representation has a single unique result.

`Ambiguous(T, T)`

Given local time representation has multiple results and thus ambiguous. This can occur when, for example, the negative timezone transition.

Implementations

impl<T> LocalResult<T>

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

Returns Some only when the conversion result is unique, or None otherwise.

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

Returns Some for the earliest possible conversion result, or None if none.

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

Returns Some for the latest possible conversion result, or None if none.

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

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

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

pub fn and_time(self, time: NaiveTime) -> LocalResult<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.

pub fn and_hms_opt(
    self,
    hour: u32,
    min: u32,
    sec: u32
) -> LocalResult<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.

pub fn and_hms_milli_opt(
    self,
    hour: u32,
    min: u32,
    sec: u32,
    milli: u32
) -> LocalResult<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.

pub fn and_hms_micro_opt(
    self,
    hour: u32,
    min: u32,
    sec: u32,
    micro: u32
) -> LocalResult<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.

pub fn and_hms_nano_opt(
    self,
    hour: u32,
    min: u32,
    sec: u32,
    nano: u32
) -> LocalResult<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.

impl<T: Debug> LocalResult<T>

pub fn unwrap(self) -> T

Returns the single unique conversion result, or panics accordingly.

Trait Implementations

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

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

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

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

Formats the value using the given formatter. Read more

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

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,

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

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

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

This method tests for self and other values to be equal, and is used by ==. Read more

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

This method tests for !=.

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

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

impl<T> StructuralEq for LocalResult<T>

impl<T> StructuralPartialEq for LocalResult<T>

Auto Trait Implementations

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

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

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

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

const: unstable · source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

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

const: unstable · source

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

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

const: unstable · source

pub fn from(t: T) -> T

Returns the argument unchanged.

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

const: unstable · source

pub fn into(self) -> U

Calls U::from(self).

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

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

type Owned = T

The resulting type after obtaining ownership.

pub fn to_owned(&self) -> T

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

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

🔬 This is a nightly-only experimental API. (toowned_clone_into)

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

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

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

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.

const: unstable · source

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

Performs the conversion.