Struct Timestamp 

pub struct Timestamp(/* private fields */);

An instant in time represented as the number of nanoseconds since the Unix epoch.

Implementations

impl Timestamp

pub fn now() -> Self

Create the timestamp of now.

pub fn format_date(self) -> String

Format the timestamp into date: 20220301

pub fn format_iso8601(self) -> String

Format the timestamp into ISO8601: 20220313T072004Z

pub fn format_http_date(self) -> String

Format the timestamp into http date: Sun, 06 Nov 1994 08:49:37 GMT

Note

HTTP date is slightly different from RFC2822.

• Timezone is fixed to GMT.
• Day must be 2 digit.

pub fn format_rfc3339_zulu(self) -> String

Format the timestamp into RFC3339 in Zulu: 2022-03-13T07:20:04Z

pub fn as_second(self) -> i64

Returns this timestamp as a number of seconds since the Unix epoch.

This only returns the number of whole seconds. That is, if there are any fractional seconds in this timestamp, then they are truncated.

pub fn subsec_nanosecond(self) -> i32

Returns the fractional second component of this timestamp in units of nanoseconds.

It is guaranteed that this will never return a value that is greater than 1 second (or less than -1 second).

pub fn as_system_time(self) -> SystemTime

Convert to SystemTime.

pub fn from_millisecond(millis: i64) -> Result<Self>

Creates a new instant in time from the number of milliseconds elapsed since the Unix epoch.

When millisecond is negative, it corresponds to an instant in time before the Unix epoch. A smaller number corresponds to an instant in time further into the past.

pub fn from_second(second: i64) -> Result<Self>

Creates a new instant in time from the number of seconds elapsed since the Unix epoch.

When second is negative, it corresponds to an instant in time before the Unix epoch. A smaller number corresponds to an instant in time further into the past.

pub fn parse_rfc2822(s: &str) -> Result<Timestamp>

Parse a timestamp from RFC2822.

All of them are valid time:

• Sat, 13 Jul 2024 15:09:59 -0400
• Mon, 15 Aug 2022 16:50:12 GMT

pub fn parse_datetime_utc(s: &str) -> Result<Timestamp>

Parse the string format “2023-10-31 21:59:10.000000”.

Trait Implementations

impl Add<Duration> for Timestamp

type Output = Timestamp

The resulting type after applying the + operator.

fn add(self, rhs: Duration) -> Timestamp

Performs the + operation.

impl AddAssign<Duration> for Timestamp

fn add_assign(&mut self, rhs: Duration)

Performs the += operation.

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

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

Formats the value using the given formatter.

impl FromStr for Timestamp

fn from_str(s: &str) -> Result<Self, Self::Err>

Parse a timestamp by the default DateTimeParser.

All of them are valid time:

• 2022-03-13T07:20:04Z
• 2022-03-01T08:12:34+00:00
• 2022-03-01T08:12:34.00+00:00
• 2022-07-08T02:14:07+02:00[Europe/Paris]

type Err = Error

The associated error which can be returned from parsing.

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

fn cmp(&self, other: &Timestamp) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

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

fn partial_cmp(&self, other: &Timestamp) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Sub<Duration> for Timestamp

type Output = Timestamp

The resulting type after applying the - operator.

fn sub(self, rhs: Duration) -> Timestamp

Performs the - operation.

impl SubAssign<Duration> for Timestamp

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl Copy for Timestamp

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp