Struct TimeFormat

pub struct TimeFormat { /* private fields */ }

The style of timestamp to be formatted for tracing events.

Format strings are used by jiff::fmt::strtime, and local timezone handling is provided by the jiff crate.

Implementations

impl TimeFormat

pub const LOCAL_FORMAT: &'static str = "[%Y-%m-%dT%H:%M:%S%z]"

RFC 3339 timestamp enclosed in square brackets, with offset.

pub const UTC_FORMAT: &'static str = "[%Y-%m-%dT%H:%M:%SZ]"

RFC 3339 timestamp enclosed in square brackets, with UTC (using ‘Z’ for the timezone instead of ‘+0000’)

pub const fn none() -> Self

Do not render a timestamp.

pub const fn local() -> Self

Render a timestamp in the local timezone using the default format.

pub const fn utc() -> Self

Render a timestamp in UTC using the default format.

pub fn local_custom(format: impl Into<String>) -> Self

Render a timestamp in the local timezone using a custom format.

Panics: When debug_assertions are enabled, the format string is validated to ensure that no unknown % fields are present. In release mode, formatting the timestamp fails and tracing-subscriber will emit “Unable to format the following event” messages.

pub fn utc_custom(format: impl Into<String>) -> Self

Render a timestamp in UTC using a custom format.

Panics: When debug_assertions are enabled, the format string is validated to ensure that no unknown % fields are present. In release mode, formatting the timestamp fails and tracing-subscriber will emit “Unable to format the following event” messages.

pub fn render(&self, ts: Timestamp) -> impl Display + '_

Get a Display-able object of this format applied to a Timestamp.

pub fn render_now(&self) -> impl Display + '_

Render the current system time in this format

Trait Implementations

impl Clone for TimeFormat

fn clone(&self) -> TimeFormat

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TimeFormat

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

Formats the value using the given formatter.

impl Default for TimeFormat

fn default() -> Self

Returns the “default value” for a type.