Struct uuid::timestamp::Timestamp

source ·
pub struct Timestamp { /* private fields */ }
Expand description

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

Implementations§

source§

impl Timestamp

source

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.

source

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.

source

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.

source

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.

source

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.

source

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§

source§

impl Clone for Timestamp

source§

fn clone(&self) -> Timestamp

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Debug for Timestamp

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl Hash for Timestamp

source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl PartialEq for Timestamp

source§

fn eq(&self, other: &Timestamp) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Copy for Timestamp

source§

impl Eq for Timestamp

source§

impl StructuralPartialEq for Timestamp

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

source§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.