Struct TimestampDisplayWithOffset

pub struct TimestampDisplayWithOffset { /* private fields */ }

A type for formatting a Timestamp with a specific offset.

This type is created by the Timestamp::display_with_offset method.

Like the std::fmt::Display trait implementation for Timestamp, this always emits an RFC 3339 compliant string. Unlike Timestamp’s Display trait implementation, which always uses Z or “Zulu” time, this always uses an offfset.

Forrmatting options supported

• std::fmt::Formatter::precision can be set to control the precision of the fractional second component.

Example

use jiff::{tz, Timestamp};

let offset = tz::offset(-5);
let ts = Timestamp::new(1_123_456_789, 123_000_000)?;
assert_eq!(
    format!("{ts:.6}", ts = ts.display_with_offset(offset)),
    "2005-08-07T18:19:49.123000-05:00",
);
// Precision values greater than 9 are clamped to 9.
assert_eq!(
    format!("{ts:.300}", ts = ts.display_with_offset(offset)),
    "2005-08-07T18:19:49.123000000-05:00",
);
// A precision of 0 implies the entire fractional
// component is always truncated.
assert_eq!(
    format!("{ts:.0}", ts = ts.display_with_offset(tz::Offset::UTC)),
    "2005-08-07T23:19:49+00:00",
);

Trait Implementations

impl Clone for TimestampDisplayWithOffset

fn clone(&self) -> TimestampDisplayWithOffset

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TimestampDisplayWithOffset

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

Formats the value using the given formatter.

impl Display for TimestampDisplayWithOffset

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

Formats the value using the given formatter.

impl Copy for TimestampDisplayWithOffset