Struct Timestamp 

pub struct Timestamp { /* private fields */ }

A date and time represented as seconds since 1900-01-01 00:00:00.

Timestamp is a simple wrapper around a u64 with a couple of convenience functions.

Implementations

impl Timestamp

pub const MAX_REPRESENTABLE_DATE_TIME: DateTime

The maximum DateTime that can be represented as Timestamp.

use leap_seconds::{Date, DateTime, Time, Timestamp};

let alt_max_1 = DateTime {
    date: Date::new(584_554_051_153, 11, 9)?,
    time: Time::new(7, 0, 15)?,
};

let alt_max_2 = Timestamp::from_u64(u64::MAX).date_time();

assert_eq!(Timestamp::MAX_REPRESENTABLE_DATE_TIME, alt_max_1);
assert_eq!(Timestamp::MAX_REPRESENTABLE_DATE_TIME, alt_max_2);

pub const MIN_REPRESENTABLE_DATE_TIME: DateTime

The minimum DateTime that can be represented as Timestamp.

use leap_seconds::{Date, DateTime, Time, Timestamp};

let alt_min_1 = DateTime {
    date: Date::new(1900, 1, 1)?,
    time: Time::new(0, 0, 0)?,
};

let alt_min_2 = Timestamp::from_u64(0).date_time();

assert_eq!(Timestamp::MIN_REPRESENTABLE_DATE_TIME, alt_min_1);
assert_eq!(Timestamp::MIN_REPRESENTABLE_DATE_TIME, alt_min_2);

pub fn from_date_time( date_time: DateTime, ) -> Result<Self, DateTimeNotRepresentable>

Creates a new Timestamp from a DateTime.

Errors

Fails if the DateTime is not representable as a Timestamp.

use leap_seconds::{Date, DateTime, Time, Timestamp};

let error = Timestamp::from_date_time(DateTime {
    date: Date::new(1899, 1, 1).expect("valid date"),
    time: Time::new(12, 0, 0).expect("valid time"),
});

assert!(error.is_err());

pub const fn from_u64(value: u64) -> Self

Creates a new Timestamp from a u64.

pub fn now() -> Self

Returns the current time.

pub const fn as_u64(self) -> u64

Gets the integer representation of this Timestamp.

pub const fn date_time(self) -> DateTime

Gets the date and time of this Timestamp.

pub const fn time(self) -> Time

Gets the time of this Timestamp.

pub const fn date(self) -> Date

Gets the date of this Timestamp.

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

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

Formats the value using the given formatter.

impl From<Timestamp> for DateTime

fn from(timestamp: Timestamp) -> Self

Converts to this type from the input type.

impl From<Timestamp> for u64

fn from(timestamp: Timestamp) -> u64

Converts to this type from the input type.

impl From<u64> for Timestamp

fn from(timestamp: u64) -> Timestamp

Converts to this type from the input type.

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 TryFrom<DateTime> for Timestamp

type Error = DateTimeNotRepresentable

The type returned in the event of a conversion error.

fn try_from(date_time: DateTime) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Timestamp

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp