Struct ion_rs::types::timestamp::Timestamp

source · [−]

pub struct Timestamp { /* private fields */ }

Expand description

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 from_datetime<D>(datetime: D, precision: Precision) -> Timestamp where
D: Datelike + Timelike + Into<Timestamp>,

Converts a NaiveDateTime or DateTime to a Timestamp with the specified precision. If the precision is Precision::FractionalSeconds, nanosecond precision is assumed.

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

If the precision is Precision::FractionalSeconds, returns a 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) -> MonthSetter

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

pub fn with_ymd(year: u32, month: u32, day: u32) -> HourAndMinuteSetter

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

pub fn with_ymd_hms(
    year: u32,
    month: u32,
    day: u32,
    hour: u32,
    minute: u32,
    second: u32
) -> FractionalSecondSetter

Creates a TimestampBuilder with the specified year, month, day, hour, minute, and second. Its precision is set to Precision::Second.

pub fn with_ymd_hms_millis(
    year: u32,
    month: u32,
    day: u32,
    hour: u32,
    minute: u32,
    second: u32,
    milliseconds: u32
) -> FractionalSecondSetter

Creates a TimestampBuilder with the specified year, month, day, hour, minute, second and milliseconds. Its precision is set to Precision::FractionalSeconds.

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) -> Precision

Returns the precision that has been specified in the Timestamp.

Trait Implementations

impl Clone for Timestamp

fn clone(&self) -> Timestamp

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

impl Debug for Timestamp

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

Formats the value using the given formatter. Read more

impl From<DateTime<FixedOffset>> for Timestamp

fn from(fixed_offset_date_time: DateTime<FixedOffset>) -> Self

Converts to this type from the input type.

impl From<IonDateTime> for Timestamp

fn from(ionc_dt: IonDateTime) -> Self

Converts to this type from the input type.

impl From<NaiveDateTime> for Timestamp

fn from(date_time: NaiveDateTime) -> Self

Converts to this type from the input type.

impl<'val> From<Timestamp> for BorrowedElement<'val>

fn from(timestamp_val: Timestamp) -> Self

Converts to this type from the input type.

impl From<Timestamp> for OwnedElement

fn from(timestamp_val: Timestamp) -> Self

Converts to this type from the input type.

impl PartialEq<Timestamp> for Timestamp

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

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

1.0.0 · source

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

This method tests for !=.

impl TryInto<DateTime<FixedOffset>> for Timestamp

type Error = IonError

The type returned in the event of a conversion error.

fn try_into(self) -> Result<DateTime<FixedOffset>, Self::Error>

Performs the conversion.

impl TryInto<IonDateTime> for Timestamp

In general there should be 1-to-1 fidelity between these types, but there is no static way to guarantee this because of Decimal and the public constructor for IonDateTime.

type Error = IonError

The type returned in the event of a conversion error.

fn try_into(self) -> Result<IonDateTime, Self::Error>

Performs the conversion.

impl TryInto<NaiveDateTime> for Timestamp

type Error = IonError

The type returned in the event of a conversion error.

fn try_into(self) -> Result<NaiveDateTime, Self::Error>

Performs the conversion.

Auto Trait Implementations

impl RefUnwindSafe for Timestamp

impl Send for Timestamp

impl Sync for Timestamp

impl Unpin for Timestamp

impl UnwindSafe for Timestamp

Blanket Implementations

impl<T> Any for T where
T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

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

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.