Struct uuid::timestamp::Timestamp

pub struct Timestamp {
    seconds: u64,
    subsec_nanos: u32,
    counter: u128,
    usable_counter_bits: u8,
}

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

Fields

seconds: u64

subsec_nanos: u32

counter: u128

usable_counter_bits: u8

Implementations

impl Timestamp

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

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) -> Self

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, ) -> Self

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, ) -> Self

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.

const fn unix_to_gregorian_ticks(seconds: u64, nanos: u32) -> u64

const fn gregorian_to_unix(ticks: u64) -> (u64, u32)

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

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method 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