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 offset.

Formatting 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",
);

# Ok::<(), Box<dyn std::error::Error>>(())