Struct concordium_contracts_common::Timestamp

#[repr(transparent)]
pub struct Timestamp {
    pub millis: u64,
}

Timestamp represented as milliseconds since unix epoch.

Timestamps from before January 1st 1970 at 00:00 are not supported.

Fields

millis: u64

Milliseconds since unix epoch.

Implementations

impl Timestamp

pub fn now() -> Self

Construct a timestamp corresponding to the current date and time.

pub const fn from_timestamp_millis(millis: u64) -> Self

Construct timestamp from milliseconds since unix epoch.

pub const fn timestamp_millis(&self) -> u64

Milliseconds since the UNIX epoch.

pub fn checked_add(self, duration: Duration) -> Option<Self>

Add duration to the timestamp. Returns None if the resulting timestamp is not representable, i.e., too far in the future.

pub fn checked_sub(self, duration: Duration) -> Option<Self>

Subtract duration from the timestamp. Returns None instead of overflowing if the resulting timestamp would be before the Unix epoch.

pub fn duration_between(self, other: Timestamp) -> Duration

Compute the duration between the self and another timestamp. The duration is always positive, and is the difference between the the more recent timestamp and the one further in the past.

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

Compute duration since a given timestamp. Returns None if given time is in the future compared to self.

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

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

Formats the value using the given formatter.

impl Deserial for Timestamp

fn deserial<R: Read>(source: &mut R) -> ParseResult<Self>

Attempt to read a structure from a given source, failing if an error occurs during deserialization or reading.

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

Deserialize from a string via the RFC3339 format.

fn deserialize<D: Deserializer<'de>>(des: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for Timestamp

This display implementation attempts to format the timestamp as per the RFC3339 standard, using the UTC time zone. If parsing the timestamp into a chrono::DateTime<Utc> fails, it simply returns the timestamp in milliseconds as a string.

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

Formats the value using the given formatter.

impl From<u64> for Timestamp

fn from(millis: u64) -> Self

Converts to this type from the input type.

impl FromStr for Timestamp

The FromStr parses a string representing either an u64 of milliseconds or the time according to RFC3339.

type Err = ParseTimestampError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

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

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, 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 + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq 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: &Rhs) -> bool

This method 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

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

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

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

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

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

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

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

impl SchemaType for Timestamp

fn get_type() -> Type

impl Serial for Timestamp

fn serial<W: Write>(&self, out: &mut W) -> Result<(), W::Err>

Attempt to write the structure into the provided writer, failing if only part of the structure could be written.

impl Serialize for Timestamp

The JSON serialization serialized the string obtained by using the Display implementation of the Timestamp.

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

Serialize this value into the given Serde serializer.

impl TryFrom<DateTime<Utc>> for Timestamp

Note that this is a lossy conversion from a datetime to a Timestamp. Any precision above milliseconds is lost.

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Timestamp> for DateTime<Utc>

type Error = TimestampOverflow

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Copy for Timestamp

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp