Struct Timestamp 

pub struct Timestamp { /* private fields */ }

A point in time, measured in microseconds since the Unix epoch.

Implementations

impl Timestamp

pub const UNIX_EPOCH: Timestamp

pub fn now() -> Timestamp

pub fn to_micros_since_unix_epoch(self) -> i64

Get the number of microseconds self is offset from Self::UNIX_EPOCH.

A positive value means a time after the Unix epoch, and a negative value means a time before.

pub fn from_micros_since_unix_epoch(micros: i64) -> Timestamp

Construct a Timestamp which is micros microseconds offset from Self::UNIX_EPOCH.

A positive value means a time after the Unix epoch, and a negative value means a time before.

pub fn from_time_duration_since_unix_epoch( time_duration: TimeDuration, ) -> Timestamp

pub fn to_time_duration_since_unix_epoch(self) -> TimeDuration

pub fn to_duration_since_unix_epoch(self) -> Result<Duration, Duration>

Returns Err(duration_before_unix_epoch) if self is before Self::UNIX_EPOCH.

pub fn from_duration_since_unix_epoch(duration: Duration) -> Timestamp

Return a Timestamp which is Timestamp::UNIX_EPOCH plus duration.

Panics if duration.as_micros overflows an i64

pub fn to_system_time(self) -> SystemTime

Convert self into a SystemTime which refers to approximately the same point in time.

This conversion may lose precision, as SystemTime’s prevision varies depending on platform. E.g. Unix targets have microsecond precision, but Windows only 100-microsecond precision.

This conversion may panic if self is out of bounds for SystemTime. We are not aware of any platforms for which SystemTime offers a smaller range than Timestamp, but such a platform may exist.

pub fn from_system_time(system_time: SystemTime) -> Timestamp

Convert a SystemTime into a Timestamp which refers to approximately the same point in time.

This conversion may panic if system_time is out of bounds for Duration. SystemTime’s range is larger than Timestamp on both Unix and Windows targets, so times in the far past or far future may panic. Timestamp’s range is approximately 292 years before and after the Unix epoch.

pub fn duration_since(self, earlier: Timestamp) -> Option<Duration>

Returns the Duration delta between self and earlier, if earlier predates self.

Returns None if earlier is strictly greater than self, or if the difference between earlier and self overflows an i64.

pub fn time_duration_since(self, earlier: Timestamp) -> Option<TimeDuration>

Returns the TimeDuration delta between self and earlier.

The result may be negative if earlier is actually later than self.

Returns None if the subtraction overflows or underflows i64 microseconds.

pub fn parse_from_rfc3339(str: &str) -> Result<Timestamp, Error>

Parses an RFC 3339 formatted timestamp string

pub fn checked_add(&self, duration: TimeDuration) -> Option<Timestamp>

Returns Some(t) where t is the time self + duration if t can be represented as a Timestamp, i.e. a 64-bit signed number of microseconds before or after the Unix epoch.

pub fn checked_sub(&self, duration: TimeDuration) -> Option<Timestamp>

Returns Some(t) where t is the time self - duration if t can be represented as a Timestamp, i.e. a 64-bit signed number of microseconds before or after the Unix epoch.

pub fn checked_add_duration(&self, duration: Duration) -> Option<Timestamp>

Returns Some(self + duration), or None if that value would be out-of-bounds for Timestamp.

Converts duration into a TimeDuration before the arithmetic. Depending on the target platform’s representation of Duration, this may lose precision.

pub fn checked_sub_duration(&self, duration: Duration) -> Option<Timestamp>

Returns Some(self - duration), or None if that value would be out-of-bounds for Timestamp.

Converts duration into a TimeDuration before the arithmetic. Depending on the target platform’s representation of Duration, this may lose precision.

pub fn to_chrono_date_time(&self) -> Result<DateTime<Utc>, Error>

pub fn to_rfc3339(&self) -> Result<String, Error>

Returns an RFC 3339 and ISO 8601 date and time string such as 1996-12-19T16:39:57-08:00.

Trait Implementations

impl Add<Duration> for Timestamp

type Output = Timestamp

The resulting type after applying the + operator.

fn add(self, other: Duration) -> <Timestamp as Add<Duration>>::Output

Performs the + operation.

impl Add<TimeDuration> for Timestamp

type Output = Timestamp

The resulting type after applying the + operator.

fn add(self, other: TimeDuration) -> <Timestamp as Add<TimeDuration>>::Output

Performs the + operation.

impl AddAssign<Duration> for Timestamp

fn add_assign(&mut self, other: Duration)

Performs the += operation.

impl AddAssign<TimeDuration> for Timestamp

fn add_assign(&mut self, other: TimeDuration)

Performs the += operation.

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<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Timestamp

fn deserialize<D>( deserializer: D, ) -> Result<Timestamp, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given deserializer.

impl Display for Timestamp

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

Formats the value using the given formatter.

impl From<SystemTime> for Timestamp

fn from(system_time: SystemTime) -> Timestamp

Converts to this type from the input type.

impl From<Timestamp> for AlgebraicValue

fn from(value: Timestamp) -> AlgebraicValue

Converts to this type from the input type.

impl From<Timestamp> for ScheduleAt

fn from(value: Timestamp) -> Self

Converts to this type from the input type.

impl GroundSpacetimeType for Timestamp

fn get_type() -> AlgebraicType

Returns the AlgebraicType representation of Self.

impl Hash for Timestamp

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

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 Ord for Timestamp

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

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

fn serialize<S>( &self, __serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize self in the data format of S using the provided serializer.

impl SpacetimeType for Timestamp

fn make_type<S>(_ts: &mut S) -> AlgebraicType

where S: TypespaceBuilder,

Returns an AlgebraicType representing the type for Self in SATS and in the typing context in typespace. This is used by the automatic type registration system in Rust modules.

impl Sub<Duration> for Timestamp

type Output = Timestamp

The resulting type after applying the - operator.

fn sub(self, other: Duration) -> <Timestamp as Sub<Duration>>::Output

Performs the - operation.

impl Sub<TimeDuration> for Timestamp

type Output = Timestamp

The resulting type after applying the - operator.

fn sub(self, other: TimeDuration) -> <Timestamp as Sub<TimeDuration>>::Output

Performs the - operation.

impl SubAssign<Duration> for Timestamp

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl SubAssign<TimeDuration> for Timestamp

fn sub_assign(&mut self, rhs: TimeDuration)

Performs the -= operation.

impl Copy for Timestamp

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp