Struct TimeValue

pub struct TimeValue(/* private fields */);

A single time value (duration)

This time value represent a duration and could be infinite.

Implementations

impl TimeValue

pub fn from_ticks(t: i64) -> Self

Creates a new time value for a number of clock ticks.

A clock tick is the smallest duration of time taken into account by this crate. It is about a nanosecond.

A tick is exactly defined as 1/2^30 seconds

If the given number of ticks is less than -TimeValue::INFINITE or greater than TimeValue::INFINITE, the time value is set to infinite.

If you are sure that the number of ticks is within the finite range value, using the unsafe version Self::from_ticks_unchecked could be considered

pub unsafe fn from_ticks_unchecked(t: i64) -> Self

Creates a new time value for a number of clock ticks.

A clock tick is the smallest duration of time taken into account by this crate.

Safety

If the given number of ticks is less than -TimeValue::INFINITE or greater than TimeValue::INFINITE, the behaviour of the time value is unpredictable.

For a safety use, consider Self::from_ticks.

pub fn from_secs(sec: i64) -> Self

Duration from a number of seconds

pub fn from_years(years: i64) -> Self

Duration from a number of years

Important note: a year is defined as an average duration of a little less than 365.25 in order to take into account leap years. More precisely, a year is defined as 146097/400 days.

pub fn from_months(months: i64) -> Self

Duration from a number of months

Important note: a month is defined as one twelfth of a year. It is therefore defined as a duration of just under 30.5 days.

pub fn from_weeks(weeks: i64) -> Self

Duration from a number of weeks

A week is defined as a duration of 7 days.

pub fn from_days(days: i64) -> Self

Duration from a number of days

A day is defined as a duration of 24 hours.

pub fn from_hours(hours: i64) -> Self

Duration from a number of hours

A hour is defined as a duration of 60 minutes (or 3600s).

pub fn from_mins(mins: i64) -> Self

Duration from a number of minutes

A minute is defined as a duration of 60 seconds.

pub fn from_millis(millis: i64) -> Self

Approximate duration from a number of milliseconds

Important note: the fractional part of a second is represented in ticks which is an internal representation close to (but not equal) the nanosecond.

pub fn from_micros(micros: i64) -> Self

Approximate duration from a number of microseconds

Important note: the fractional part of a second is represented in ticks which is an internal representation close to (but not equal) the nanosecond.

pub fn from_nanos(nanos: i64) -> Self

Approximate duration from a number of nanoseconds

Important note: the fractional part of a second is represented in ticks which is an internal representation close to (but not equal) the nanosecond.

pub fn as_ticks(&self) -> i64

pub fn as_secs(&self) -> i64

pub fn subsec_millis(&self) -> i32

Fractional part of a time value (milliseconds)

Important note: the fractional part of a second is represented in ticks which is an internal representation close to (but not equal) the nanosecond.

pub fn subsec_micros(&self) -> i32

Fractional part of a time value (microseconds)

Important note: the fractional part of a second is represented in ticks which is an internal representation close to (but not equal) the nanosecond.

pub fn subsec_nanos(&self) -> i32

Fractional part of the time value (nanoseconds)

Important note: the fractional part of a second is represented in ticks which is an internal representation close to (but not equal) the nanosecond.

pub fn to_duration(&self) -> Duration

pub fn is_zero(&self) -> bool

pub fn is_positive(&self) -> bool

pub fn is_negative(&self) -> bool

pub fn is_strictly_positive(&self) -> bool

pub fn is_strictly_negative(&self) -> bool

pub fn floor(self, period: TimeValue) -> Self

pub fn ceil(self, period: TimeValue) -> Self

Trait Implementations

impl<T> Add<TimeInterval<T>> for TimeValue

where T: TimePoint + Add<TimeValue, Output = T>,

type Output = TimeInterval<T>

The resulting type after applying the + operator.

fn add(self, other: TimeInterval<T>) -> Self::Output

Performs the + operation.

impl<T> Add<TimeValue> for TimeInterval<T>

where T: TimePoint + Add<TimeValue, Output = T>,

type Output = TimeInterval<T>

The resulting type after applying the + operator.

fn add(self, other: TimeValue) -> Self::Output

Performs the + operation.

impl<T: TimePoint> Add<TimeValue> for TimeSet<T>

where TimeInterval<T>: Add<TimeValue, Output = TimeInterval<T>>,

type Output = TimeSet<T>

The resulting type after applying the + operator.

fn add(self, other: TimeValue) -> Self::Output

Performs the + operation.

impl Add<TimeValue> for Timestamp

type Output = Timestamp

The resulting type after applying the + operator.

fn add(self, other: TimeValue) -> Self::Output

Performs the + operation.

impl Add<Timestamp> for TimeValue

type Output = Timestamp

The resulting type after applying the + operator.

fn add(self, tw: Self::Output) -> Self::Output

Performs the + operation.

impl Add for TimeValue

type Output = TimeValue

The resulting type after applying the + operator.

fn add(self, other: Self) -> Self

Performs the + operation.

impl<T> AddAssign<TimeValue> for TimeInterval<T>

where T: TimePoint + AddAssign<TimeValue>,

fn add_assign(&mut self, other: TimeValue)

Performs the += operation.

impl<T: TimePoint> AddAssign<TimeValue> for TimeSet<T>

where TimeInterval<T>: AddAssign<TimeValue>,

fn add_assign(&mut self, t: TimeValue)

Performs the += operation.

impl AddAssign<TimeValue> for Timestamp

fn add_assign(&mut self, other: TimeValue)

Performs the += operation.

impl AddAssign for TimeValue

fn add_assign(&mut self, other: TimeValue)

Performs the += operation.

impl<TW> BitAnd<TW> for TimeValue

where TW: TimeConvex<TimePoint = TimeValue>,

type Output = TimeInterval<TimeValue>

The resulting type after applying the & operator.

fn bitand(self, tw: TW) -> Self::Output

Performs the & operation.

impl<TW> BitOr<TW> for TimeValue

where TW: TimeConvex<TimePoint = TimeValue>,

type Output = TimeSet<TimeValue>

The resulting type after applying the | operator.

fn bitor(self, tw: TW) -> Self::Output

Performs the | operation.

impl Clone for TimeValue

fn clone(&self) -> TimeValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimeValue

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

Formats the value using the given formatter.

impl Default for TimeValue

fn default() -> TimeValue

Returns the “default value” for a type.

impl Display for TimeValue

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

Formats the value using the given formatter.

impl Div<f32> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: f32) -> Self::Output

Performs the / operation.

impl Div<f64> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: f64) -> Self::Output

Performs the / operation.

impl Div<i128> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: i128) -> Self::Output

Performs the / operation.

impl Div<i16> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: i16) -> Self::Output

Performs the / operation.

impl Div<i32> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: i32) -> Self::Output

Performs the / operation.

impl Div<i64> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: i64) -> Self::Output

Performs the / operation.

impl Div<i8> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: i8) -> Self::Output

Performs the / operation.

impl Div<isize> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: isize) -> Self::Output

Performs the / operation.

impl Div<u128> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: u128) -> Self::Output

Performs the / operation.

impl Div<u16> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: u16) -> Self::Output

Performs the / operation.

impl Div<u32> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: u32) -> Self::Output

Performs the / operation.

impl Div<u64> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: u64) -> Self::Output

Performs the / operation.

impl Div<u8> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: u8) -> Self::Output

Performs the / operation.

impl Div<usize> for TimeValue

type Output = TimeValue

The resulting type after applying the / operator.

fn div(self, n: usize) -> Self::Output

Performs the / operation.

impl DivAssign<f32> for TimeValue

fn div_assign(&mut self, n: f32)

Performs the /= operation.

impl DivAssign<f64> for TimeValue

fn div_assign(&mut self, n: f64)

Performs the /= operation.

impl DivAssign<i128> for TimeValue

fn div_assign(&mut self, n: i128)

Performs the /= operation.

impl DivAssign<i16> for TimeValue

fn div_assign(&mut self, n: i16)

Performs the /= operation.

impl DivAssign<i32> for TimeValue

fn div_assign(&mut self, n: i32)

Performs the /= operation.

impl DivAssign<i64> for TimeValue

fn div_assign(&mut self, n: i64)

Performs the /= operation.

impl DivAssign<i8> for TimeValue

fn div_assign(&mut self, n: i8)

Performs the /= operation.

impl DivAssign<isize> for TimeValue

fn div_assign(&mut self, n: isize)

Performs the /= operation.

impl DivAssign<u128> for TimeValue

fn div_assign(&mut self, n: u128)

Performs the /= operation.

impl DivAssign<u16> for TimeValue

fn div_assign(&mut self, n: u16)

Performs the /= operation.

impl DivAssign<u32> for TimeValue

fn div_assign(&mut self, n: u32)

Performs the /= operation.

impl DivAssign<u64> for TimeValue

fn div_assign(&mut self, n: u64)

Performs the /= operation.

impl DivAssign<u8> for TimeValue

fn div_assign(&mut self, n: u8)

Performs the /= operation.

impl DivAssign<usize> for TimeValue

fn div_assign(&mut self, n: usize)

Performs the /= operation.

impl From<Duration> for TimeValue

fn from(t: Duration) -> Self

Converts to this type from the input type.

impl From<TimeDelta> for TimeValue

fn from(t: Duration) -> Self

Converts to this type from the input type.

impl From<TimeValue> for Duration

fn from(value: TimeValue) -> Self

Converts to this type from the input type.

impl From<TimeValue> for Duration

fn from(value: TimeValue) -> Self

Converts to this type from the input type.

impl Hash for TimeValue

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 IntoTimeValue for TimeValue

fn years(self) -> TimeValue

fn months(self) -> TimeValue

fn weeks(self) -> TimeValue

fn days(self) -> TimeValue

fn hours(self) -> TimeValue

fn mins(self) -> TimeValue

fn secs(self) -> TimeValue

fn millis(self) -> TimeValue

fn micros(self) -> TimeValue

fn nanos(self) -> TimeValue

fn ticks(self) -> TimeValue

impl Mul<TimeValue> for f32

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for f64

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for i128

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for i16

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for i32

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for i64

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for i8

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for isize

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for u128

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for u16

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for u32

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for u64

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for u8

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<TimeValue> for usize

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, t: TimeValue) -> Self::Output

Performs the * operation.

impl Mul<f32> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: f32) -> Self::Output

Performs the * operation.

impl Mul<f64> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: f64) -> Self::Output

Performs the * operation.

impl Mul<i128> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: i128) -> Self::Output

Performs the * operation.

impl Mul<i16> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: i16) -> Self::Output

Performs the * operation.

impl Mul<i32> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: i32) -> Self::Output

Performs the * operation.

impl Mul<i64> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: i64) -> Self::Output

Performs the * operation.

impl Mul<i8> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: i8) -> Self::Output

Performs the * operation.

impl Mul<isize> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: isize) -> Self::Output

Performs the * operation.

impl Mul<u128> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: u128) -> Self::Output

Performs the * operation.

impl Mul<u16> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: u16) -> Self::Output

Performs the * operation.

impl Mul<u32> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: u32) -> Self::Output

Performs the * operation.

impl Mul<u64> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: u64) -> Self::Output

Performs the * operation.

impl Mul<u8> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: u8) -> Self::Output

Performs the * operation.

impl Mul<usize> for TimeValue

type Output = TimeValue

The resulting type after applying the * operator.

fn mul(self, n: usize) -> Self::Output

Performs the * operation.

impl MulAssign<f32> for TimeValue

fn mul_assign(&mut self, n: f32)

Performs the *= operation.

impl MulAssign<f64> for TimeValue

fn mul_assign(&mut self, n: f64)

Performs the *= operation.

impl MulAssign<i128> for TimeValue

fn mul_assign(&mut self, n: i128)

Performs the *= operation.

impl MulAssign<i16> for TimeValue

fn mul_assign(&mut self, n: i16)

Performs the *= operation.

impl MulAssign<i32> for TimeValue

fn mul_assign(&mut self, n: i32)

Performs the *= operation.

impl MulAssign<i64> for TimeValue

fn mul_assign(&mut self, n: i64)

Performs the *= operation.

impl MulAssign<i8> for TimeValue

fn mul_assign(&mut self, n: i8)

Performs the *= operation.

impl MulAssign<isize> for TimeValue

fn mul_assign(&mut self, n: isize)

Performs the *= operation.

impl MulAssign<u128> for TimeValue

fn mul_assign(&mut self, n: u128)

Performs the *= operation.

impl MulAssign<u16> for TimeValue

fn mul_assign(&mut self, n: u16)

Performs the *= operation.

impl MulAssign<u32> for TimeValue

fn mul_assign(&mut self, n: u32)

Performs the *= operation.

impl MulAssign<u64> for TimeValue

fn mul_assign(&mut self, n: u64)

Performs the *= operation.

impl MulAssign<u8> for TimeValue

fn mul_assign(&mut self, n: u8)

Performs the *= operation.

impl MulAssign<usize> for TimeValue

fn mul_assign(&mut self, n: usize)

Performs the *= operation.

impl Neg for TimeValue

type Output = TimeValue

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Not for TimeValue

type Output = TimeSet<TimeValue>

The resulting type after applying the ! operator.

fn not(self) -> Self::Output

Performs the unary ! operation.

impl Ord for TimeValue

fn cmp(&self, other: &TimeValue) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for TimeValue

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

fn partial_cmp(&self, other: &TimeValue) -> 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<T> Sub<TimeInterval<T>> for TimeValue

where T: TimePoint + Add<TimeValue, Output = T>,

type Output = TimeInterval<T>

The resulting type after applying the - operator.

fn sub(self, other: TimeInterval<T>) -> Self::Output

Performs the - operation.

impl<T> Sub<TimeValue> for TimeInterval<T>

where T: TimePoint + Sub<TimeValue, Output = T>,

type Output = TimeInterval<T>

The resulting type after applying the - operator.

fn sub(self, other: TimeValue) -> Self::Output

Performs the - operation.

impl<T: TimePoint> Sub<TimeValue> for TimeSet<T>

where TimeInterval<T>: Sub<TimeValue, Output = TimeInterval<T>>,

type Output = TimeSet<T>

The resulting type after applying the - operator.

fn sub(self, other: TimeValue) -> Self::Output

Performs the - operation.

impl Sub<TimeValue> for Timestamp

type Output = Timestamp

The resulting type after applying the - operator.

fn sub(self, other: TimeValue) -> Self::Output

Performs the - operation.

impl Sub<Timestamp> for TimeValue

type Output = Timestamp

The resulting type after applying the - operator.

fn sub(self, tw: Self::Output) -> Self::Output

Performs the - operation.

impl Sub for TimeValue

type Output = TimeValue

The resulting type after applying the - operator.

fn sub(self, v: TimeValue) -> Self

Performs the - operation.

impl<T> SubAssign<TimeValue> for TimeInterval<T>

where T: TimePoint + SubAssign<TimeValue>,

fn sub_assign(&mut self, other: TimeValue)

Performs the -= operation.

impl<T: TimePoint> SubAssign<TimeValue> for TimeSet<T>

where TimeInterval<T>: SubAssign<TimeValue>,

fn sub_assign(&mut self, t: TimeValue)

Performs the -= operation.

impl SubAssign<TimeValue> for Timestamp

fn sub_assign(&mut self, other: TimeValue)

Performs the -= operation.

impl SubAssign for TimeValue

fn sub_assign(&mut self, v: TimeValue)

Performs the -= operation.

impl Sum for TimeValue

fn sum<I: Iterator<Item = Self>>(iter: I) -> Self

Takes an iterator and generates Self from the elements by “summing up” the items.

impl TimeBounds for TimeValue

type TimePoint = TimeValue

The type of the underlying time data.

fn is_empty(&self) -> bool

Checks if this time window is empty

fn is_singleton(&self) -> bool

Checks if this time window contains exactly one value

fn is_bounded(&self) -> bool

Checks if this time window is bounded

fn is_low_bounded(&self) -> bool

Checks if this time window has a finite lower bound

fn is_up_bounded(&self) -> bool

Checks if this time window has a finite upper bound

fn lower_bound(&self) -> Self::TimePoint

The lower bound of the time window

fn upper_bound(&self) -> Self::TimePoint

The upper bound of the time window

impl TimePoint for TimeValue

const INFINITE: TimeValue

The infinite time point (∞) which is used to infinite time window bounds

fn is_future_infinite(&self) -> bool

Checks if this value equals +∞

fn is_past_infinite(&self) -> bool

Checks if this value equals -∞

fn is_finite(&self) -> bool

Checks if this value is finite

fn just_after(&self) -> TimeValue

Returns a value just after this one

fn just_before(&self) -> TimeValue

Returns a value just before this one

impl TimePointFormat for TimeValue

fn format_timepoint(self, _timefmt: &str) -> String

impl<I: TimeConvexIterator> TimeTranslation<TimeValue> for I

where I::Item: Add<TimeValue, Output = I::Item>,

type Output = TimeValueTranslIter<I>

fn translation(self, t: TimeValue) -> Self::Output

impl Copy for TimeValue

impl Eq for TimeValue

impl StructuralPartialEq for TimeValue

impl TimeConvex for TimeValue