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 Considerations in RFC 9562
• UUID Generator States in RFC 9562

Implementations

impl Timestamp

pub fn now(context: impl ClockSequence<Output = impl Into<u128>>) -> Timestamp

Get a timestamp representing the current system time and up to a 128-bit counter.

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

pub const fn from_gregorian(ticks: u64, counter: u16) -> Timestamp

Construct a Timestamp from the number of 100 nanosecond ticks since 00:00:00.00, 15 October 1582 (the date of Gregorian reform to the Christian calendar) and a 14-bit counter, as used in versions 1 and 6 UUIDs.

Overflow

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

pub const fn from_unix_time( seconds: u64, subsec_nanos: u32, counter: u128, usable_counter_bits: u8, ) -> Timestamp

Construct a Timestamp from a Unix timestamp and up to a 128-bit counter, as used in version 7 UUIDs.

pub fn from_unix( context: impl ClockSequence<Output = impl Into<u128>>, seconds: u64, subsec_nanos: u32, ) -> Timestamp

Construct a Timestamp from a Unix timestamp and up to a 128-bit counter, as used in version 7 UUIDs.

pub const fn to_gregorian(&self) -> (u64, u16)

Get the value of the timestamp as the number of 100 nanosecond ticks since 00:00:00.00, 15 October 1582 and a 14-bit counter, as used in versions 1 and 6 UUIDs.

Overflow

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

If the internal counter is wider than 14 bits then it will be truncated to 14 bits.

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

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

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<(), Error>

Formats the value using the given formatter.

impl Hash for Timestamp

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

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