Struct UtcTime

Source

pub struct UtcTime<F> { /* private fields */ }

Available on crate features fmt and std and time only.

Expand description

Formats the current UTC time using a formatter from the time crate.

To format the current local time instead, use the LocalTime type.

Implementations§

Source §

impl UtcTime<Rfc3339>

Source

pub fn rfc_3339() -> Self

Returns a formatter that formats the current [UTC time] in the RFC 3339 format, which is a subset of the ISO 8601 timestamp format.

§Examples

use better_tracing::fmt::{self, time};

let subscriber = better_tracing::fmt()
    .with_timer(time::UtcTime::rfc_3339());

Source §

impl UtcTime<Vec<FormatItem<'static>>>

Source

pub fn rfc3339_seconds() -> Self

RFC3339 with no fractional seconds and ‘Z’.

Source

pub fn rfc3339_millis() -> Self

RFC3339 with 3 fractional digits (milliseconds) and ‘Z’.

Source

pub fn rfc3339_nanos() -> Self

RFC3339 with 9 fractional digits (nanoseconds) and ‘Z’.

Source

pub fn time_only_secs() -> Self

Time-of-day with whole seconds, no suffix: HH:MM:SS

Source

pub fn time_only_millis() -> Self

Time-of-day with milliseconds, no suffix: HH:MM:SS.mmm

Source

pub fn time_only_micros() -> Self

Time-of-day with microseconds, no suffix: HH:MM:SS.uuuuuu

Source §

impl<F: Formattable> UtcTime<F>

Source

pub fn new(format: F) -> Self

Returns a formatter that formats the current UTC time using the time crate, with the provided provided format. The format may be any type that implements the Formattable trait.

Typically, the format will be a format description string, or one of the time crate’s well-known formats.

If the format description is statically known, then the format_description! macro should be used. This is identical to the time::format_description::parse method, but runs at compile-time, failing an error if the format description is invalid. If the desired format is not known statically (e.g., a user is providing a format string), then the time::format_description::parse method should be used. Note that this method is fallible.

See the time book for details on the format description syntax.

§Examples

Using the format_description! macro:

use better_tracing::fmt::{self, time::UtcTime};
use time::macros::format_description;

let timer = UtcTime::new(format_description!("[hour]:[minute]:[second]"));
let subscriber = better_tracing::fmt()
    .with_timer(timer);

Using the format_description! macro requires enabling the time crate’s “macros” feature flag.

Using time::format_description::parse:

use better_tracing::fmt::{self, time::UtcTime};

let time_format = time::format_description::parse("[hour]:[minute]:[second]")
    .expect("format string should be valid!");
let timer = UtcTime::new(time_format);
let subscriber = better_tracing::fmt()
    .with_timer(timer);

Using a well-known format (this is equivalent to UtcTime::rfc_3339):

use better_tracing::fmt::{self, time::UtcTime};

let timer = UtcTime::new(time::format_description::well_known::Rfc3339);
let subscriber = better_tracing::fmt()
    .with_timer(timer);