Struct pgdatetime::Interval

#[repr(C)]pub struct Interval { /* fields omitted */ }

Interval represents delta time.

Implementations

impl Interval

pub const fn new() -> Self

Construct a Interval value.

pub fn try_from_ymwd_hms(
    years: i32,
    months: i32,
    weeks: i32,
    days: i32,
    hours: i32,
    minutes: i32,
    seconds: f64
) -> Result<Interval, DateTimeError>

Constructs Interval from year, month, weak, day, hour, minute and second. second can indicate millisecond and microsecond.

pub fn add_interval(self, span: Self) -> Result<Self, DateTimeError>

Interval subtracts Interval.

pub fn negate(self) -> Result<Self, DateTimeError>

Negate of Interval.

pub fn sub_interval(self, span: Self) -> Result<Self, DateTimeError>

Interval subtracts Interval.

pub fn justify_hours(self) -> Self

Adjusts Interval. so time of Interval contains less than a whole day, adding the excess to day of Interval. This is useful for situations (such as non-TZ) where '1 day' = '24 hours' is valid, e.g. interval subtraction and division.

pub fn justify_days(self) -> Self

Adjust Interval so day of Interval contains less than 30 days, adding the excess to 'month'.

pub fn justify_interval(self) -> Self

Adjusts Interval. so month, day, and time portions are within customary bounds. Specifically: 0 <= abs(time) < 24 hours 0 <= abs(day) < 30 days Also, the sign bit on all three fields is made equal, so either all three fields are negative or all are positive.

pub fn mul_f64(self, factor: f64) -> Result<Self, DateTimeError>

Interval multiply float64.

pub fn div_f64(self, factor: f64) -> Result<Self, DateTimeError>

Interval divides float64.

pub fn try_from_str(
    s: &str,
    type_mod: i32,
    format_type: IntervalStyle
) -> Result<Self, DateTimeError>

Parses Internal from string.

pub fn format(
    self,
    interval_format: IntervalStyle
) -> Result<String, DateTimeError>

Converts Interval to string.

Trait Implementations

impl Add<Interval> for Interval

Used for no overflow checked.

type Output = Interval

The resulting type after applying the + operator.

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

Performs the + operation.

impl Clone for Interval

fn clone(&self) -> Interval

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Interval

impl DateTime for Interval

fn date_part(
    &self,
    ty: FieldType,
    unit: DateUnit
) -> Result<Option<f64>, DateTimeError>

Extracts specified field from Interval.

fn is_finite(&self) -> bool

Checks whether Interval is finite.

fn truncate(&self, ty: FieldType, unit: DateUnit) -> Result<Self, DateTimeError>

Truncates Interval to specified units.

fn is_infinite(&self) -> bool

Checks whether date time is infinite.

impl Debug for Interval

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

Formats the value using the given formatter.

impl Eq for Interval

impl From<Interval> for i128

fn from(span: Interval) -> Self

Performs the conversion.

impl From<Interval> for Time

Converts Interval to Time. This is defined as producing the fractional-day portion of the interval. Therefore, we can just ignore the months field. It is not real clear what to do with negative intervals, but we choose to subtract the floor, so that, say, '-2 hours' becomes '22:00:00'.

fn from(value: Interval) -> Self

Performs the conversion.

impl From<Time> for Interval

Converts Time to Interval.

fn from(value: Time) -> Self

Performs the conversion.

impl Hash for Interval

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, 

Feeds a slice of this type into the given Hasher.

impl Ord for Interval

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

This method returns an Ordering between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl PartialEq<Interval> for Interval

fn eq(&self, other: &Interval) -> bool

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

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

This method tests for !=.

impl PartialOrd<Interval> for Interval

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

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

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]fn le(&self, other: &Rhs) -> bool

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

#[must_use]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

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

impl StructuralEq for Interval

impl StructuralPartialEq for Interval