Struct twilight_model::util::datetime::TimestampIso8601Display

pub struct TimestampIso8601Display { /* private fields */ }

Display implementation to format a Timestamp in an ISO 8601 format.

Examples

Format a timestamp as an ISO 8601 datetime both with microseconds:

use twilight_model::util::Timestamp;

let timestamp = Timestamp::from_micros(1_628_594_197_020_000)?;
assert_eq!(
    "2021-08-10T11:16:37.020000+00:00",
    timestamp.iso_8601().to_string(),
);

Implementations

impl TimestampIso8601Display

pub const fn get(self) -> Timestamp

Get the inner timestamp.

pub const fn with_microseconds(self, with_microseconds: bool) -> Self

Whether to format the timestamp with microseconds.

The ISO 8601 display formatter formats with microseconds by default.

Examples

Format a timestamp with microseconds:

use twilight_model::util::Timestamp;

let timestamp = Timestamp::from_micros(1_628_594_197_020_000)?;
let formatter = timestamp.iso_8601().with_microseconds(true);

assert_eq!("2021-08-10T11:16:37.020000+00:00", formatter.to_string());

Format a timestamp without microseconds:

use twilight_model::util::Timestamp;

let timestamp = Timestamp::from_micros(1_628_594_197_020_000)?;
let formatter = timestamp.iso_8601().with_microseconds(false);

assert_eq!("2021-08-10T11:16:37+00:00", formatter.to_string());

Trait Implementations

impl Debug for TimestampIso8601Display

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

Formats the value using the given formatter.

impl Display for TimestampIso8601Display

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

Formats the value using the given formatter.

impl Serialize for TimestampIso8601Display

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.