Struct Timestamp 

pub struct Timestamp {
    pub secs: i64,
    pub nanos: u32,
}

An instant: seconds since the Unix epoch, plus a nanosecond fraction.

The seconds are signed, so a time before 1970 is an ordinary value rather than a special case. The fraction is nanoseconds within the second and is normally below NANOS_PER_SEC — a timestamp decoded from an image need not be, because the field it came out of may be wider than the second it divides, and what is reported is what the image holds.

The type is exhaustive: an instant is a second and a fraction, and there is no field it could grow.

Fields

secs: i64

Seconds since the Unix epoch, negative before it.

nanos: u32

Nanoseconds within the second, normally 0..1_000_000_000.

Implementations

impl Timestamp

pub const NANOS_PER_SEC: u32 = 1_000_000_000

One past the largest fraction that divides a second.

pub const fn from_secs(secs: i64) -> Self

An instant at secs seconds past the epoch, with no sub-second part.

pub const fn civil(self) -> Civil

The civil date and time of day this instant reads as, UTC.

The fraction is not carried across: a civil reading is a calendar position, and what divides its final second is still nanos.

let civil = Timestamp::from_secs(1_700_000_000).civil();
assert_eq!((civil.year, civil.month, civil.day), (2023, 11, 14));
assert_eq!((civil.hour, civil.minute, civil.second), (22, 13, 20));

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

Formats the value using the given formatter.

impl Default for Timestamp

fn default() -> Timestamp

Returns the “default value” for a type.

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