Struct Timestamp

pub struct Timestamp { /* private fields */ }

A timestamp that can be encoded into a UUID.

This type abstracts the specific encoding, so versions 1, 6, and 7 UUIDs can both be supported through the same type, even though they have a different representation of a timestamp.

References

• Timestamp in RFC4122
• Timestamp in Draft RFC: New UUID Formats, Version 4
• Clock Sequence in RFC4122

Implementations

impl Timestamp

pub fn now(context: impl ClockSequence<Output = u16>) -> Self

Get a timestamp representing the current system time.

This method defers to the standard library’s SystemTime type.

Panics

This method will panic if calculating the elapsed time since the Unix epoch fails.

pub const fn from_rfc4122(ticks: u64, counter: u16) -> Self

Construct a Timestamp from an RFC4122 timestamp and counter, as used in versions 1 and 6 UUIDs.

Overflow

If conversion from RFC4122 ticks to the internal timestamp format would overflow it will wrap.

pub fn from_unix( context: impl ClockSequence<Output = u16>, seconds: u64, nanos: u32, ) -> Self

Construct a Timestamp from a Unix timestamp, as used in version 7 UUIDs.

Overflow

If conversion from RFC4122 ticks to the internal timestamp format would overflow it will wrap.

pub const fn to_unix(&self) -> (u64, u32)

Get the value of the timestamp as a Unix timestamp, as used in version 7 UUIDs.

Overflow

If conversion from RFC4122 ticks to the internal timestamp format would overflow it will wrap.

pub const fn to_unix_nanos(&self) -> u32

👎Deprecated: use to_unix instead; this method will be removed in a future release

Get the number of fractional nanoseconds in the Unix timestamp.

This method is deprecated and probably doesn’t do what you’re expecting it to. It doesn’t return the timestamp as nanoseconds since the Unix epoch, it returns the fractional seconds of the timestamp.

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

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp