Struct Timestamp

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

A point in time in nanosecond precision.

This type can represent times from 1970-01-01T00:00:00Z to 2554-07-21T23:34:33Z.

Examples

let ts = Timestamp::from_nanos(1_000_000_202);
assert_eq!(ts.nanos(), 1_000_000_202);
assert_eq!(ts.seconds(), 1);
assert_eq!(ts.subsec_nanos(), 202);

let ts = ts.plus_seconds(2);
assert_eq!(ts.nanos(), 3_000_000_202);
assert_eq!(ts.seconds(), 3);
assert_eq!(ts.subsec_nanos(), 202);

Implementations

impl Timestamp

pub const fn from_nanos(nanos_since_epoch: u64) -> Self

Creates a timestamp from nanoseconds since epoch

pub const fn from_seconds(seconds_since_epoch: u64) -> Self

Creates a timestamp from seconds since epoch

pub const fn plus_days(&self, addition: u64) -> Timestamp

Adds the given amount of days to the timestamp and returns the result. The original value remains unchanged.

Panics if the result exceeds the value range of Timestamp.

pub const fn plus_hours(&self, addition: u64) -> Timestamp

Adds the given amount of hours to the timestamp and returns the result. The original value remains unchanged.

Panics if the result exceeds the value range of Timestamp.

pub const fn plus_minutes(&self, addition: u64) -> Timestamp

Adds the given amount of minutes to the timestamp and returns the result. The original value remains unchanged.

Panics if the result exceeds the value range of Timestamp.

pub const fn plus_seconds(&self, addition: u64) -> Timestamp

Adds the given amount of seconds to the timestamp and returns the result. The original value remains unchanged.

Panics if the result exceeds the value range of Timestamp.

pub const fn plus_nanos(&self, addition: u64) -> Timestamp

Adds the given amount of nanoseconds to the timestamp and returns the result. The original value remains unchanged.

Panics if the result exceeds the value range of Timestamp.

pub const fn minus_days(&self, subtrahend: u64) -> Timestamp

Subtracts the given amount of days from the timestamp and returns the result. The original value remains unchanged.

Panics if the result is not >= 0. I.e. times before epoch cannot be represented.

pub const fn minus_hours(&self, subtrahend: u64) -> Timestamp

Subtracts the given amount of hours from the timestamp and returns the result. The original value remains unchanged.

Panics if the result is not >= 0. I.e. times before epoch cannot be represented.

pub const fn minus_minutes(&self, subtrahend: u64) -> Timestamp

Subtracts the given amount of minutes from the timestamp and returns the result. The original value remains unchanged.

Panics if the result is not >= 0. I.e. times before epoch cannot be represented.

pub const fn minus_seconds(&self, subtrahend: u64) -> Timestamp

Subtracts the given amount of seconds from the timestamp and returns the result. The original value remains unchanged.

Panics if the result is not >= 0. I.e. times before epoch cannot be represented.

pub const fn minus_nanos(&self, subtrahend: u64) -> Timestamp

Subtracts the given amount of nanoseconds from the timestamp and returns the result. The original value remains unchanged.

Panics if the result is not >= 0. I.e. times before epoch cannot be represented.

pub fn nanos(&self) -> u64

Returns nanoseconds since epoch

pub fn seconds(&self) -> u64

Returns seconds since epoch (truncate nanoseconds)

pub fn subsec_nanos(&self) -> u64

Returns nanoseconds since the last whole second (the remainder truncated by seconds())

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

fn default() -> Timestamp

Returns the “default value” for a type.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

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

fn from(timestamp: Timestamp) -> IbcTimeout

Converts to this type from the input type.

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Timestamp

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp