Struct Timestamp 

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

A pkarr timestamp in microseconds since the UNIX epoch.

Used as the seq field in BEP_0044 DHT mutable items. Per the spec, a new publish must have a strictly higher timestamp than the previous one, or DHT nodes will reject the update.

Timestamp::now is guaranteed to be strictly monotonic: it will never return the same value twice and will never go backward, even if the system clock is corrected by NTP. This is achieved by tracking the last returned value and ensuring each call returns at least last + 1.

Implementations

impl Timestamp

pub fn now() -> Self

Returns a strictly monotonic timestamp.

Guaranteed to return a value greater than any previous call, even if the system clock jumps backward (e.g. due to NTP correction).

pub fn from_micros(micros: u64) -> Self

Creates a timestamp from a raw microseconds value.

pub fn as_micros(self) -> u64

Returns the raw microseconds value.

pub fn to_be_bytes(self) -> [u8; 8]

Returns the big-endian byte representation.

pub fn from_be_bytes(bytes: [u8; 8]) -> Self

Parses from big-endian bytes.

Trait Implementations

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, __derive_more_f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

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,

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

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp