Struct discord_flows::model::Timestamp

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

Representation of a Unix timestamp.

The struct implements the std::fmt::Display trait to format the underlying type as an RFC 3339 date and string such as 2016-04-30T11:18:25.796Z.

let timestamp: Timestamp = GuildId(175928847299117063).created_at();
assert_eq!(timestamp.unix_timestamp(), 1462015105);
assert_eq!(timestamp.to_string(), "2016-04-30T11:18:25.796Z");

Implementations

impl Timestamp

pub fn now() -> Timestamp

Create a new Timestamp with the current date and time in UTC.

pub fn from_unix_timestamp(secs: i64) -> Result<Timestamp, InvalidTimestamp>

Create a new Timestamp from a UNIX timestamp.

Errors

Returns Err if the value is invalid. The valid range of the value may vary depending on the feature flags enabled (time with large-dates).

pub fn unix_timestamp(&self) -> i64

Returns the number of non-leap seconds since January 1, 1970 0:00:00 UTC

pub fn parse(input: &str) -> Result<Timestamp, ParseError>

Parse a timestamp from an RFC 3339 date and time string.

Examples

let timestamp = Timestamp::parse("2016-04-30T11:18:25Z").unwrap();
let timestamp = Timestamp::parse("2016-04-30T11:18:25+00:00").unwrap();
let timestamp = Timestamp::parse("2016-04-30T11:18:25.796Z").unwrap();

assert!(Timestamp::parse("2016-04-30T11:18:25").is_err());
assert!(Timestamp::parse("2016-04-30T11:18").is_err());

Errors

Returns Err if the string is not a valid RFC 3339 date and time string.

Methods from Deref<Target = OffsetDateTime>

pub const UNIX_EPOCH: OffsetDateTime = _

Trait Implementations

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<(), Error>

Formats the value using the given formatter.

impl Deref for Timestamp

type Target = OffsetDateTime

The resulting type after dereferencing.

fn deref(&self) -> &<Timestamp as Deref>::Target

Dereferences the value.

impl<'de> Deserialize<'de> for Timestamp

fn deserialize<__D>( __deserializer: __D ) -> Result<Timestamp, <__D as Deserializer<'de>>::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Timestamp

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

Formats the value using the given formatter.

impl<'a> From<&'a str> for Timestamp

fn from(s: &'a str) -> Timestamp

Parses an RFC 3339 date and time string such as 2016-04-30T11:18:25.796Z.

Panics on invalid value.

impl From<&Timestamp> for Timestamp

fn from(ts: &Timestamp) -> Timestamp

Converts to this type from the input type.

impl From<OffsetDateTime> for Timestamp

fn from(dt: OffsetDateTime) -> Timestamp

Converts to this type from the input type.

impl From<String> for Timestamp

fn from(s: String) -> Timestamp

Parses an RFC 3339 date and time string such as 2016-04-30T11:18:25.796Z.

Panics on invalid value.

impl FromStr for Timestamp

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Timestamp, <Timestamp as FromStr>::Err>

Parses a string s to return a value of this 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) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<Timestamp> for Timestamp

fn eq(&self, other: &Timestamp) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl Serialize for Timestamp

fn serialize<__S>( &self, __serializer: __S ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Timestamp

impl Eq for Timestamp

impl StructuralEq for Timestamp

impl StructuralPartialEq for Timestamp