pub struct UtcTime<F> { /* private fields */ }
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
sourceimpl<F: Formattable> UtcTime<F>
impl<F: Formattable> UtcTime<F>
sourcepub fn new(format: F) -> Self
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 tracing_subscriber::fmt::{self, time::UtcTime};
use time::macros::format_description;
let timer = UtcTime::new(format_description!("[hour]:[minute]:[second]"));
let collector = tracing_subscriber::fmt()
.with_timer(timer);
Using the format_description!
macro requires enabling the time
crate’s “macros” feature flag.
Using time::format_description::parse
:
use tracing_subscriber::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 collector = tracing_subscriber::fmt()
.with_timer(timer);
Using a well-known format (this is equivalent to
UtcTime::rfc_3339
):
use tracing_subscriber::fmt::{self, time::UtcTime};
let timer = UtcTime::new(time::format_description::well_known::Rfc3339);
let collector = tracing_subscriber::fmt()
.with_timer(timer);
Trait Implementations
sourceimpl<F> Default for UtcTime<F> where
F: Formattable + Default,
impl<F> Default for UtcTime<F> where
F: Formattable + Default,
sourceimpl<F> FormatTime for UtcTime<F> where
F: Formattable,
impl<F> FormatTime for UtcTime<F> where
F: Formattable,
sourcefn format_time(&self, w: &mut Writer<'_>) -> Result
fn format_time(&self, w: &mut Writer<'_>) -> Result
Measure and write out the current time. Read more
Auto Trait Implementations
impl<F> RefUnwindSafe for UtcTime<F> where
F: RefUnwindSafe,
impl<F> Send for UtcTime<F> where
F: Send,
impl<F> Sync for UtcTime<F> where
F: Sync,
impl<F> Unpin for UtcTime<F> where
F: Unpin,
impl<F> UnwindSafe for UtcTime<F> where
F: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcepub fn borrow_mut(&mut self) -> &mut T
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
sourcefn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
sourceimpl<T> WithSubscriber for T
impl<T> WithSubscriber for T
sourcefn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
sourcefn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more