Struct Timestamp

pub struct Timestamp {
    pub nanoseconds: u128,
}

A Timestamp represents a point in time as nanoseconds since the UNIX epoch.

Fields

nanoseconds: u128

Implementations

impl Timestamp

pub fn now() -> Self

Returns the current time as a Timestamp.

Examples

use transforms::time::Timestamp;

let now = Timestamp::now();

pub fn zero() -> Self

Returns a Timestamp representing the UNIX epoch (0 nanoseconds). This functionality is especially useful for static transforms.

Examples

use transforms::time::Timestamp;

let zero = Timestamp::zero();
assert_eq!(zero.nanoseconds, 0);

pub fn as_seconds(&self) -> Result<f64, TimestampError>

Converts the Timestamp to seconds as a floating-point number.

Returns an error if the conversion results in accuracy loss.

Examples

use transforms::time::Timestamp;

let timestamp = Timestamp {
    nanoseconds: 1_000_000_000,
};
let result = timestamp.as_seconds();
assert!(result.is_ok());
assert_eq!(result.unwrap(), 1.0);

let timestamp = Timestamp {
    nanoseconds: 1_000_000_000_000_000_001,
};
let result = timestamp.as_seconds();
assert!(result.is_err());

Errors

Returns TimestampError::AccuracyLoss if the conversion is not exact.

pub fn as_seconds_unchecked(&self) -> f64

Converts the Timestamp to seconds as a floating-point number without checking for accuracy.

Examples

use transforms::time::Timestamp;

let timestamp = Timestamp {
    nanoseconds: 1_000_000_000_000_000_001,
};
let seconds = timestamp.as_seconds_unchecked();
assert_eq!(seconds, 1_000_000_000.0);

Trait Implementations

impl Add<Duration> for Timestamp

type Output = Result<Timestamp, TimestampError>

The resulting type after applying the + operator.

fn add(self, rhs: Duration) -> Self::Output

Performs the + operation.

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 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 = Result<Timestamp, TimestampError>

The resulting type after applying the - operator.

fn sub(self, rhs: Duration) -> Self::Output

Performs the - operation.

impl Sub for Timestamp

type Output = Result<Duration, TimestampError>

The resulting type after applying the - operator.

fn sub(self, other: Timestamp) -> Self::Output

Performs the - operation.

impl Copy for Timestamp

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp