Struct Timestamp

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

A timestamp type, representing a concrete moment in time.

Implementations

impl Timestamp

pub const MAX: Timestamp

The maximum value a timestamp can have.

pub fn now() -> Self

Available on crate feature std only.

Returns the timestamp of the current moment.

pub fn elapsed(&self) -> TimeDiff

Available on crate feature std only.

Returns the time that has elapsed since this timestamp.

pub fn zero() -> Self

Returns a zero timestamp.

pub fn millis(&self) -> u64

Returns the timestamp as the number of milliseconds since the Unix epoch

pub fn saturating_diff(self, other: Timestamp) -> TimeDiff

Returns the difference between self and other, or 0 if self is earlier than other.

pub fn saturating_sub(self, other: TimeDiff) -> Timestamp

Returns the difference between self and other, or 0 if that would be before the epoch.

pub fn saturating_add(self, other: TimeDiff) -> Timestamp

Returns the sum of self and other, or the maximum possible value if that would be exceeded.

pub fn trailing_zeros(&self) -> u8

Returns the number of trailing zeros in the number of milliseconds since the epoch.

pub fn random(rng: &mut TestRng) -> Self

Available on crate feature testing only.

Returns a random Timestamp.

pub fn checked_sub(self, other: TimeDiff) -> Option<Timestamp>

Available on crate feature testing only.

Checked subtraction for timestamps

Trait Implementations

impl Add<TimeDiff> for Timestamp

type Output = Timestamp

The resulting type after applying the + operator.

fn add(self, diff: TimeDiff) -> Timestamp

Performs the + operation.

impl AddAssign<TimeDiff> for Timestamp

fn add_assign(&mut self, rhs: TimeDiff)

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

const IS_DYNAMIC: bool = false

If true, the type has a heap size that can vary at runtime, depending on the actual value.

const STATIC_HEAP_SIZE: usize = 0usize

The amount of space a value of the type always occupies. If IS_DYNAMIC is false, this is the total amount of heap memory occupied by the value. Otherwise this is a lower bound.

fn estimate_heap_size(&self) -> usize

Estimates the size of heap memory taken up by this value.

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl Default for Timestamp

fn default() -> Timestamp

Returns the “default value” for a type.

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

Available on crate feature std only.

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

Deserialize this value from the given Serde deserializer.

impl Display for Timestamp

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

Formats the value using the given formatter.

impl From<BlockTime> for Timestamp

fn from(value: BlockTime) -> Self

Converts to this type from the input type.

impl From<Timestamp> for BlockTime

fn from(value: Timestamp) -> Self

Converts to this type from the input type.

impl From<u64> for Timestamp

fn from(milliseconds_since_epoch: u64) -> Timestamp

Converts to this type from the input type.

impl FromBytes for Timestamp

fn from_bytes(bytes: &[u8]) -> Result<(Self, &[u8]), Error>

Deserializes the slice into Self.

fn from_vec(bytes: Vec<u8>) -> Result<(Self, Vec<u8>), Error>

Deserializes the Vec<u8> into Self.

impl FromStr for Timestamp

Available on crate feature std only.

type Err = Error

The associated error which can be returned from parsing.

fn from_str(value: &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 JsonSchema for Timestamp

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

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 Rem<TimeDiff> for Timestamp

type Output = TimeDiff

The resulting type after applying the % operator.

fn rem(self, diff: TimeDiff) -> TimeDiff

Performs the % operation.

impl Serialize for Timestamp

Available on crate feature std only.

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

Serialize this value into the given Serde serializer.

impl<T> Shl<T> for Timestamp

where u64: Shl<T, Output = u64>,

type Output = Timestamp

The resulting type after applying the << operator.

fn shl(self, rhs: T) -> Timestamp

Performs the << operation.

impl<T> Shr<T> for Timestamp

where u64: Shr<T, Output = u64>,

type Output = Timestamp

The resulting type after applying the >> operator.

fn shr(self, rhs: T) -> Timestamp

Performs the >> operation.

impl Sub<TimeDiff> for Timestamp

Available on crate feature testing only.

type Output = Timestamp

The resulting type after applying the - operator.

fn sub(self, diff: TimeDiff) -> Timestamp

Performs the - operation.

impl ToBytes for Timestamp

fn to_bytes(&self) -> Result<Vec<u8>, Error>

Serializes &self to a Vec<u8>.

fn serialized_length(&self) -> usize

Returns the length of the Vec<u8> which would be returned from a successful call to to_bytes() or into_bytes(). The data is not actually serialized, so this call is relatively cheap.

fn into_bytes(self) -> Result<Vec<u8>, Error>

where Self: Sized,

Consumes self and serializes to a Vec<u8>.

fn write_bytes(&self, writer: &mut Vec<u8>) -> Result<(), Error>

Writes &self into a mutable writer.

impl Copy for Timestamp

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp