Struct TimeDelta 

pub struct TimeDelta {
    pub months: i32,
    pub inner: TimeDelta,
}

Represents a duration of time with both months and a more precise duration.

This struct combines a number of months with a chrono::Duration to represent time intervals that may include calendar-specific units (months) as well as fixed-length durations.

Fields

• months: The number of months in the time delta.
• inner: A chrono::Duration representing the precise duration beyond whole months.

Serialization

When the “serde” feature is enabled, this struct can be serialized and deserialized.

Fields

months: i32

inner: TimeDelta

Implementations

impl TimeDelta

pub fn parse(duration: &str) -> Result<TimeDelta, TError>

Parse timedelta from string

for example: “2y1mo-3d5h-2m3s” Parses a string representation of a duration into a TimeDelta.

This function supports a variety of time units and can handle complex duration strings.

Supported Units

• ns: nanoseconds

• us: microseconds

• ms: milliseconds

• s: seconds

• m: minutes

• h: hours

• d: days

• w: weeks

• mo: months

• y: years

Format

The duration string should be in the format of <number><unit>, and multiple such pairs can be combined. For example: “2y1mo-3d5h-2m3s” represents 2 years, 1 month, minus 3 days, 5 hours, minus 2 minutes, and 3 seconds.

Arguments

• duration - A string slice that holds the duration to be parsed.

Returns

• TResult<Self> - A Result containing the parsed TimeDelta if successful, or an error if parsing fails.

Examples

use tea_time::TimeDelta;

let td = TimeDelta::parse("1y2mo3d4h5m6s").unwrap();
assert_eq!(td.months, 14); // 1 year and 2 months
assert_eq!(td.inner, chrono::Duration::seconds(3 * 86400 + 4 * 3600 + 5 * 60 + 6));

pub const fn nat() -> TimeDelta

pub const fn is_nat(&self) -> bool

pub const fn is_not_nat(&self) -> bool

Trait Implementations

impl<U> Add<TimeDelta> for DateTime<U>

where U: TimeUnitTrait, DateTime<U>: From<DateTime<Utc>> + TryInto<DateTime<Utc>>,

type Output = DateTime<U>

The resulting type after applying the + operator.

fn add(self, rhs: TimeDelta) -> <DateTime<U> as Add<TimeDelta>>::Output

Performs the + operation.

impl Add<TimeDelta> for Time

type Output = Time

The resulting type after applying the + operator.

fn add(self, rhs: TimeDelta) -> <Time as Add<TimeDelta>>::Output

Performs the + operation.

impl Add for TimeDelta

type Output = TimeDelta

The resulting type after applying the + operator.

fn add(self, rhs: TimeDelta) -> TimeDelta

Performs the + operation.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for TimeDelta

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl Cast<Option<bool>> for TimeDelta

fn cast(self) -> Option<bool>

Casts the value to the target type T.

impl Cast<Option<f32>> for TimeDelta

fn cast(self) -> Option<f32>

Casts the value to the target type T.

impl Cast<Option<f64>> for TimeDelta

fn cast(self) -> Option<f64>

Casts the value to the target type T.

impl Cast<Option<i32>> for TimeDelta

fn cast(self) -> Option<i32>

Casts the value to the target type T.

impl Cast<Option<i64>> for TimeDelta

Available on crate feature time only.

fn cast(self) -> Option<i64>

Casts the value to the target type T.

impl Cast<Option<isize>> for TimeDelta

fn cast(self) -> Option<isize>

Casts the value to the target type T.

impl Cast<Option<u64>> for TimeDelta

fn cast(self) -> Option<u64>

Casts the value to the target type T.

impl Cast<Option<u8>> for TimeDelta

fn cast(self) -> Option<u8>

Casts the value to the target type T.

impl Cast<Option<usize>> for TimeDelta

fn cast(self) -> Option<usize>

Casts the value to the target type T.

impl Cast<String> for TimeDelta

Available on crate feature time only.

fn cast(self) -> String

Casts the value to the target type T.

impl Cast<TimeDelta> for &str

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<TimeDelta> for DateTime<U>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for Option<bool>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for Option<f32>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for Option<f64>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for Option<i32>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for Option<i64>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for Option<isize>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for Option<u64>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for Option<u8>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for Option<usize>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for String

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for bool

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for f32

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for f64

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for i32

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for i64

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for isize

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for u64

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for u8

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<TimeDelta> for usize

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl Cast<bool> for TimeDelta

fn cast(self) -> bool

Casts the value to the target type T.

impl Cast<f32> for TimeDelta

fn cast(self) -> f32

Casts the value to the target type T.

impl Cast<f64> for TimeDelta

fn cast(self) -> f64

Casts the value to the target type T.

impl Cast<i32> for TimeDelta

fn cast(self) -> i32

Casts the value to the target type T.

impl Cast<i64> for TimeDelta

Available on crate feature time only.

fn cast(self) -> i64

Casts the value to the target type T.

impl Cast<isize> for TimeDelta

fn cast(self) -> isize

Casts the value to the target type T.

impl Cast<u64> for TimeDelta

fn cast(self) -> u64

Casts the value to the target type T.

impl Cast<u8> for TimeDelta

fn cast(self) -> u8

Casts the value to the target type T.

impl Cast<usize> for TimeDelta

fn cast(self) -> usize

Casts the value to the target type T.

impl Clone for TimeDelta

fn clone(&self) -> TimeDelta

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimeDelta

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

Formats the value using the given formatter.

impl Default for TimeDelta

fn default() -> TimeDelta

Returns the “default value” for a type.

impl Div for TimeDelta

type Output = i32

The resulting type after applying the / operator.

fn div(self, rhs: TimeDelta) -> <TimeDelta as Div>::Output

Performs the / operation.

impl From<&str> for TimeDelta

fn from(s: &str) -> TimeDelta

Converts to this type from the input type.

impl From<Option<TimeDelta>> for TimeDelta

fn from(duration: Option<TimeDelta>) -> TimeDelta

Converts to this type from the input type.

impl From<Option<i64>> for TimeDelta

fn from(dt: Option<i64>) -> TimeDelta

Converts to this type from the input type.

impl From<TimeDelta> for TimeDelta

fn from(duration: TimeDelta) -> TimeDelta

Converts to this type from the input type.

impl From<i64> for TimeDelta

fn from(dt: i64) -> TimeDelta

Converts to this type from the input type.

impl FromStr for TimeDelta

type Err = TError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<TimeDelta, <TimeDelta as FromStr>::Err>

Parses a string s to return a value of this type.

impl GetDataType for TimeDelta

fn dtype() -> DataType

Returns the DataType corresponding to the implementing type.

impl Hash for TimeDelta

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

where __H: Hasher,

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IsNone for TimeDelta

Available on crate feature time only.

type Inner = TimeDelta

type Cast<U: IsNone<Inner = U> + Clone> = U

fn is_none(&self) -> bool

Checks if the value is in the “none” state.

fn none() -> Self

Creates a new instance of Self in the “none” state.

fn to_opt(self) -> Option<Self::Inner>

Converts the value to an Option<Self::Inner>.

fn as_opt(&self) -> Option<&Self::Inner>

Converts the value to an Option<&Self::Inner>.

fn from_inner(inner: Self::Inner) -> Self

Creates a new instance of Self from the given inner value.

fn inner_cast<U: IsNone<Inner = U> + Clone>(inner: U) -> Self::Cast<U>

where Self::Inner: Cast<U::Inner>,

Casts the inner type of Self to a new type U.

fn unwrap(self) -> Self::Inner

fn map<F, U: IsNone>(self, f: F) -> U

where F: Fn(Self::Inner) -> U::Inner,

Maps a function over the inner value of Self, if it exists.

fn from_opt(opt: Option<Self::Inner>) -> Self

Creates a new instance of Self from an Option<Self::Inner>.

fn not_none(&self) -> bool

fn sort_cmp(&self, other: &Self) -> Ordering

where Self::Inner: PartialOrd,

Compares two values for sorting, treating None as the largest value.

fn sort_cmp_rev(&self, other: &Self) -> Ordering

where Self::Inner: PartialOrd,

Compares two values for reverse sorting, treating None as the largest value.

impl Mul<i32> for TimeDelta

type Output = TimeDelta

The resulting type after applying the * operator.

fn mul(self, rhs: i32) -> TimeDelta

Performs the * operation.

impl Neg for TimeDelta

type Output = TimeDelta

The resulting type after applying the - operator.

fn neg(self) -> TimeDelta

Performs the unary - operation.

impl PartialEq for TimeDelta

fn eq(&self, other: &TimeDelta) -> 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 PartialOrd for TimeDelta

fn partial_cmp(&self, other: &TimeDelta) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<U> Sub<TimeDelta> for DateTime<U>

where U: TimeUnitTrait, DateTime<U>: From<DateTime<Utc>> + TryInto<DateTime<Utc>>,

type Output = DateTime<U>

The resulting type after applying the - operator.

fn sub(self, rhs: TimeDelta) -> <DateTime<U> as Sub<TimeDelta>>::Output

Performs the - operation.

impl Sub<TimeDelta> for Time

type Output = Time

The resulting type after applying the - operator.

fn sub(self, rhs: TimeDelta) -> <Time as Sub<TimeDelta>>::Output

Performs the - operation.

impl Sub for TimeDelta

type Output = TimeDelta

The resulting type after applying the - operator.

fn sub(self, rhs: TimeDelta) -> TimeDelta

Performs the - operation.

impl Copy for TimeDelta

impl Eq for TimeDelta

impl StructuralPartialEq for TimeDelta