Struct Timestamp

pub struct Timestamp { /* private fields */ }

A representation of a timestamp (seconds and nanos since the Unix epoch).

Timestamps are able to be easily converted into chrono DateTimes.

Implementations

impl Timestamp

Creation of timestamps.

pub const fn new(seconds: i64, nanos: u32) -> Self

Create a new timestamp from the given number of seconds and nanos (nanoseconds).

The use of the ts!() macro in the unix-ts-macros crate is advised in lieu of calling this method directly for most situations.

Note: For negative timestamps, the nanos argument is always a positive offset. Therefore, the correct way to represent a timestamp of -0.25 seconds is to call new(-1, 750_000_000).

pub const fn from_nanos(nanos: i128) -> Self

Create a timestamp from the given number of nanoseconds.

pub const fn from_micros(micros: i64) -> Self

Create a timestamp from the given number of microseconds.

pub const fn from_millis(millis: i64) -> Self

Create a timestamp from the given number of milliseconds.

pub fn now() -> Self

The timestamp representing “right now”.

Panic

Panics if the system clock is set to a time prior to the Unix epoch (January 1, 1970).

impl Timestamp

Inspection of timestamps.

pub const fn seconds(&self) -> i64

Return the seconds since the Unix epoch. Sub-second values are discarded.

Examples

let t = Timestamp::from(1335020400);
assert_eq!(t.seconds(), 1335020400);

pub const fn at_precision(&self, e: u8) -> i128

Return the time since the Unix epoch, as an integer, with the given precision.

Arguments

• e (u8) - The precision for the returned integer, as a power of 10. (ex. 3 for milliseconds, 6 for microseconds, etc.). Must be a value between 0 and 9.

Examples

let t = Timestamp::from(1335020400);
assert_eq!(t.at_precision(3), 1335020400_000);
assert_eq!(t.at_precision(6), 1335020400_000_000);

pub const fn subsec(&self, e: u8) -> u32

Return the subsecond component at the specified precision (ex. 3 for milliseconds, 6 for microseconds); max precision is 9.

Arguments

• e (u8) - The precision for the returned subsecond value, as a power of 10 (ex. 3 for milliseconds, 6 for microseconds, etc.). Must be a value between 0 and 9.

Examples

let t = Timestamp::new(1335020400, 500_000_000);
assert_eq!(t.subsec(1), 5);
assert_eq!(t.subsec(3), 500);

Trait Implementations

impl Add<Duration> for Timestamp

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

Add the provided duration to the timestamp.

type Output = Timestamp

The resulting type after applying the + operator.

impl<T: Into<i64> + Int> Add<T> for Timestamp

fn add(self, other: T) -> Timestamp

Add the provided duration to the timestamp.

type Output = Timestamp

The resulting type after applying the + operator.

impl AddAssign<Duration> for Timestamp

fn add_assign(&mut self, other: Duration)

Add the provided duration to the timestamp, in-place.

impl<T: Into<i64> + Int> AddAssign<T> for Timestamp

fn add_assign(&mut self, other: T)

Add the provided duration to the timestamp, in-place.

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 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<T: Into<i64> + Int> From<T> for Timestamp

fn from(secs: T) -> Self

Create a new timestamp for the given number of seconds.

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<T: Into<i64> + Int> Rem<T> for Timestamp

fn rem(self, other: T) -> Timestamp

Subtract the provided duration to the timestamp.

type Output = Timestamp

The resulting type after applying the % operator.

impl Sub<Duration> for Timestamp

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

Subtract the provided duration from the timestamp.

type Output = Timestamp

The resulting type after applying the - operator.

impl<T: Into<i64> + Int> Sub<T> for Timestamp

fn sub(self, other: T) -> Timestamp

Subtract the provided duration to the timestamp.

type Output = Timestamp

The resulting type after applying the - operator.

impl SubAssign<Duration> for Timestamp

fn sub_assign(&mut self, other: Duration)

Subtract the provided duration to the timestamp, in-place.

impl<T: Into<i64> + Int> SubAssign<T> for Timestamp

fn sub_assign(&mut self, other: T)

Subtract the provided duration to the timestamp, in-place.

impl Copy for Timestamp

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp