Struct pgdatetime::Timestamp

#[repr(transparent)]pub struct Timestamp(_);

Timestamp represents absolute time.

Implementations

impl Timestamp

pub fn try_from_ymd_hms(
    year: i32,
    month: i32,
    day: i32,
    hour: i32,
    minute: i32,
    second: f64
) -> Result<Self, DateTimeError>

Construct Timestamp from year, month, day, hour, minute, second. Second can indicate millisecond and microsecond.

pub fn try_from_str(
    s: &str,
    type_mod: i32,
    date_order: DateOrder
) -> Result<Timestamp, DateTimeError>

Parses Timestamp string. type_mode should be -1, or 1~6, else will be error.

pub fn format(
    self,
    date_style: DateStyle,
    date_order: DateOrder
) -> Result<String, DateTimeError>

Converts Timestamp to string.

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

Timestamp add Interval. Note that interval has provisions for qualitative year/month and day units, so try to do the right thing with them. To add a month, increment the month, and use the same day of month. Then, if the next month has fewer days, set the day of month to the last day of month. To add a day, increment the mday, and use the same time of day. Lastly, add in the "quantitative time".

pub fn add_time(self, time: Time) -> Result<Timestamp, DateTimeError>

Timestamp adds Time.

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

Timestamp subtracts Interval.

pub fn sub_date(self, date: Date) -> Result<Interval, DateTimeError>

Timestamp subtracts Date.

pub fn sub_time(self, time: Time) -> Result<Timestamp, DateTimeError>

Timestamp subtracts Time.

pub fn sub_timestamp(
    self,
    timestamp: Timestamp
) -> Result<Interval, DateTimeError>

Timestamp subtracts Timestamp.

pub fn age(self, timestamp: Timestamp) -> Result<Interval, DateTimeError>

Calculates time difference while retaining year/month fields. Note that this does not result in an accurate absolute time span since year and month are out of context once the arithmetic is done.

Trait Implementations

impl Clone for Timestamp

fn clone(&self) -> Timestamp

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Timestamp

impl DateTime for Timestamp

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

Extracts specified field from Timestamp.

fn is_finite(&self) -> bool

Checks whether Timestamp is finite.

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

Truncates Timestamp to specified units.

fn is_infinite(&self) -> bool

Checks whether date time is infinite.

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl Eq for Timestamp

impl From<Timestamp> for i64

Converts timestamp to i64 type.

fn from(t: Timestamp) -> Self

Performs the conversion.

impl From<i64> for Timestamp

Converts i64 to timestamp type.

fn from(v: i64) -> Self

Performs the conversion.

impl Hash for Timestamp

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 Timestamp

fn cmp(&self, other: &Timestamp) -> 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<Timestamp> for Timestamp

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

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

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

This method tests for !=.

impl PartialOrd<Timestamp> for Timestamp

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

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

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

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

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

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

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

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

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

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

impl StructuralEq for Timestamp

impl StructuralPartialEq for Timestamp

impl TryFrom<Date> for Timestamp

Converts Date to Timestamp.

type Error = DateTimeError

The type returned in the event of a conversion error.

fn try_from(value: Date) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Timestamp> for Date

Converts timestamp to date.

type Error = DateTimeError

The type returned in the event of a conversion error.

fn try_from(value: Timestamp) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Timestamp> for Option<Time>

Converts Timestamp to Time.

type Error = DateTimeError

The type returned in the event of a conversion error.

fn try_from(value: Timestamp) -> Result<Self, Self::Error>

Performs the conversion.