Struct Timestamp 

pub struct Timestamp { /* private fields */ }

Represents a point in time to a specified degree of precision. Unlike chrono’s NaiveDateTime and DateTime, a Timestamp has variable precision ranging from a year to fractional seconds of an arbitrary unit.

Implementations

impl Timestamp

pub fn fractional_seconds_scale(&self) -> Option<i64>

If the precision is TimestampPrecision::Second, returns the Decimal scale of this Timestamp’s fractional seconds; otherwise, returns None.

For example, a Timestamp with 553 milliseconds would return a Decimal scale of 3.

pub fn with_year(year: u32) -> TimestampBuilder<HasYear>

Creates a TimestampBuilder with the specified year and TimestampPrecision::Year.

pub fn with_ymd(year: u32, month: u32, day: u32) -> TimestampBuilder<HasDay>

Creates a TimestampBuilder with the specified year, month, and day. Its precision is set to TimestampPrecision::Day.

pub fn offset(&self) -> Option<i32>

Returns the offset in minutes that has been specified in the Timestamp. A positive value indicates Eastern Hemisphere, while a negative value indicates Western Hemisphere.

pub fn precision(&self) -> TimestampPrecision

Returns the precision that has been specified in the Timestamp.

pub fn year(&self) -> u32

Returns the year that has been specified in the Timestamp.

pub fn month(&self) -> u32

Returns the month that has been specified in the Timestamp. Returns the month number starting from 1. The return value ranges from 1 to 12.

pub fn day(&self) -> u32

Returns the day that has been specified in the Timestamp. Returns the day of month starting from 1.

pub fn hour(&self) -> u32

Returns the hour(s) that has been specified in the Timestamp. Returns the hour number from 0 to 23.

pub fn minute(&self) -> u32

Returns the minute(s) that has been specified in the Timestamp. Returns the minute number from 0 to 59.

pub fn second(&self) -> u32

Returns the second(s) that has been specified in the Timestamp. Returns the second number from 0 to 59.

pub fn to_utc(&self) -> Timestamp

Return a UTC timestamp for this Timestamp

pub fn nanoseconds(&self) -> u32

Returns this Timestamp’s fractional seconds in nanoseconds

NOTE: This is a potentially lossy operation. A Timestamp with picoseconds would return a number of nanoseconds, losing precision. If it loses precision then truncation is performed. (e.g. a timestamp with fractional seconds of 0.000000000999 would return 0)

pub fn microseconds(&self) -> u32

Returns this Timestamp’s fractional seconds in microseconds

NOTE: This is a potentially lossy operation. A Timestamp with picoseconds would return a number of microseconds, losing precision. If it loses precision then truncation is performed. (e.g. a timestamp with fractional seconds of 0.000000999 would return 0)

pub fn milliseconds(&self) -> u32

Returns this Timestamp’s fractional seconds in milliseconds

NOTE: This is a potentially lossy operation. A Timestamp with picoseconds would return a number of milliseconds, losing precision. If it loses precision then truncation is performed. (e.g. a timestamp with fractional seconds of 0.000999 would return 0)

Trait Implementations

impl Clone for Timestamp

fn clone(&self) -> Timestamp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl Display for Timestamp

Formats an ISO-8601 timestamp of appropriate precision and offset.

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

Formats the value using the given formatter.

impl Eq for Timestamp

impl From<Timestamp> for Value

fn from(timestamp_val: Timestamp) -> Self

Converts to this type from the input type.

impl Ord for Timestamp

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

Two Timestamps are considered equal (though not necessarily IonEq) if they represent the same instant in time. TimestampPrecision is ignored. Offsets do not have to match as long as the instants being represented match. Examples:

• 2022T == 2022T-01
• 2022T == 2022T-01-01T00:00:00.000+00:00
• 2022T-05-11T12:00:00.000Z == 2022T-05-11T07:00:00.000-05:00

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

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 TryFrom<Element> for Timestamp

type Error = ConversionOperationError<Element, Timestamp>

The type returned in the event of a conversion error.

fn try_from(element: Element) -> ConversionOperationResult<Element, Timestamp>

Performs the conversion.