Struct Timestamp 

pub struct Timestamp(/* private fields */);

A Unix timestamp with nanosecond precision.

Implementations

impl Timestamp

pub const MIN: Timestamp

The minimum timestamp, 1970-01-01T00:00:00Z.

pub const MAX: Timestamp

The maximum timestamp, 9999-12-31T23:59:59.999999999Z.

pub fn from_unix(unix_time: Duration) -> Option<Timestamp>

Try create a timestamp from time since the Unix epoch.

If the unix_time is within Timestamp::MIN..=Timestamp::MAX then this method will return Some. Otherwise it will return None.

pub fn to_unix(&self) -> Duration

Get the value of the timestamp as time since the Unix epoch.

pub fn try_from_str(ts: &str) -> Result<Timestamp, ParseTimestampError>

Try parse a timestamp from an RFC3339 formatted representation.

pub fn parse(ts: impl Display) -> Result<Timestamp, ParseTimestampError>

Try parse a timestamp from an RFC3339 formatted value.

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

Calculate the timespan between two timestamps.

This method will return None if earlier is actually after self.

pub fn from_system_time(ts: SystemTime) -> Option<Timestamp>

Convert a system timestamp into a timestamp.

If the ts is within Timestamp::MIN..=Timestamp::MAX then this method will return Some. Otherwise it will return None.

pub fn to_system_time(&self) -> SystemTime

Convert the timestamp into a system timestamp.

This method can be used for interoperability with code expecting a standard library timestamp.

pub fn from_parts(parts: Parts) -> Option<Timestamp>

Try get a timestamp from its individual date and time parts.

If the resulting timestamp is within Timestamp::MIN..=Timestamp::MAX then this method will return Some. If it’s outside then it will return None. If any of the fields in parts is out of range for its type, such as days: 32, then this method will also return None.

pub fn to_parts(&self) -> Parts

Get the individual date and time parts of the timestamp.

The returned parts are in exactly the form needed to display them. Months and days are both one-based.

pub fn checked_add(&self, rhs: Duration) -> Option<Timestamp>

Add a duration to this timestamp.

If the result would be greater than Timestamp::MAX then None is returned.

pub fn checked_sub(&self, rhs: Duration) -> Option<Timestamp>

Subtract a duration to this timestamp.

If the result would be less than Timestamp::MIN then None is returned.

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

Get the duration between this timestamp and an earlier one.

Trait Implementations

impl Add<Duration> for Timestamp

type Output = Timestamp

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<Duration> for Timestamp

fn add_assign(&mut self, rhs: Duration)

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

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl Display for Timestamp

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

Formats the value using the given formatter.

impl Eq for Timestamp

impl FromStr for Timestamp

type Err = ParseTimestampError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Timestamp, <Timestamp as FromStr>::Err>

Parses a string s to return a value of this type.

impl<'v> FromValue<'v> for Timestamp

fn from_value(value: Value<'v>) -> Option<Timestamp>

Perform the conversion.

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<'a> PartialEq<&'a Timestamp> for Timestamp

fn eq(&self, other: &&'a 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<'a> PartialEq<Timestamp> for &'a 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

Available on crate feature serde only.

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Timestamp

impl Sub for Timestamp

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<Duration> for Timestamp

type Output = Timestamp

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<Duration> for Timestamp

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl ToExtent for Timestamp

fn to_extent(&self) -> Option<Extent>

Perform the conversion.

impl ToValue for Timestamp

fn to_value(&self) -> Value<'_>

Perform the conversion.

impl Value for Timestamp

Available on crate feature sval only.

fn stream<'sval, S>(&'sval self, stream: &mut S) -> Result<(), Error>

where S: Stream<'sval> + ?Sized,

Stream this value through a Stream.

fn tag(&self) -> Option<Tag>

Get the tag of this value, if there is one.

fn to_bool(&self) -> Option<bool>

Try convert this value into a boolean.

fn to_f32(&self) -> Option<f32>

Try convert this value into a 32bit binary floating point number.

fn to_f64(&self) -> Option<f64>

Try convert this value into a 64bit binary floating point number.

fn to_i8(&self) -> Option<i8>

Try convert this value into a signed 8bit integer.

fn to_i16(&self) -> Option<i16>

Try convert this value into a signed 16bit integer.

fn to_i32(&self) -> Option<i32>

Try convert this value into a signed 32bit integer.

fn to_i64(&self) -> Option<i64>

Try convert this value into a signed 64bit integer.

fn to_i128(&self) -> Option<i128>

Try convert this value into a signed 128bit integer.

fn to_u8(&self) -> Option<u8>

Try convert this value into an unsigned 8bit integer.

fn to_u16(&self) -> Option<u16>

Try convert this value into an unsigned 16bit integer.

fn to_u32(&self) -> Option<u32>

Try convert this value into an unsigned 32bit integer.

fn to_u64(&self) -> Option<u64>

Try convert this value into an unsigned 64bit integer.

fn to_u128(&self) -> Option<u128>

Try convert this value into an unsigned 128bit integer.

fn to_text(&self) -> Option<&str>

Try convert this value into a text string.

fn to_binary(&self) -> Option<&[u8]>

Try convert this value into a bitstring.