Struct tea_time::TimeDelta

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

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: Duration

Implementations

impl TimeDelta

pub fn parse(duration: &str) -> TResult<Self>

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() -> Self

pub const fn is_nat(&self) -> bool

pub const fn is_not_nat(&self) -> bool

Trait Implementations

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

where Self: From<DateTime<Utc>> + TryInto<DateTime<Utc>>,

type Output = DateTime<U>

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<TimeDelta> for Time

type Output = Time

The resulting type after applying the + operator.

fn add(self, rhs: TimeDelta) -> Self::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 Clone for TimeDelta

fn clone(&self) -> TimeDelta

Returns a copy 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

Formats the value using the given formatter.

impl Default for TimeDelta

fn default() -> Self

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) -> Self::Output

Performs the / operation.

impl From<&str> for TimeDelta

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<TimeDelta> for TimeDelta

fn from(duration: Duration) -> Self

Converts to this type from the input type.

impl From<i64> for TimeDelta

fn from(dt: i64) -> Self

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<Self, Self::Err>

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

impl Hash for TimeDelta

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

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 Mul<i32> for TimeDelta

type Output = TimeDelta

The resulting type after applying the * operator.

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

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: &Self) -> 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: TimeUnitTrait> Sub<TimeDelta> for DateTime<U>

where Self: From<DateTime<Utc>> + TryInto<DateTime<Utc>>,

type Output = DateTime<U>

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<TimeDelta> for Time

type Output = Time

The resulting type after applying the - operator.

fn sub(self, rhs: TimeDelta) -> Self::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