🛈 Note: This is pre-release documentation for the upcoming tracing 0.2.0 ecosystem.

For the release documentation, please see docs.rs, instead.

tracing_subscriber::fmt::time

Struct LocalTime

Source
pub struct LocalTime<F> { /* private fields */ }
Available on crate feature fmt and crate feature std and unsound_local_offset and crate feature local-time only.
Expand description

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

To format the current UTC time instead, use the UtcTime type.

    Warning: The time
    crate must be compiled with --cfg unsound_local_offset in order to use
    local timestamps. When this cfg is not enabled, local timestamps cannot be recorded, and
    events will be logged without timestamps.

See the time documentation for more details.

Implementations§

Source§

impl LocalTime<Rfc3339>

Source

pub fn rfc_3339() -> Self

Returns a formatter that formats the current local time in the RFC 3339 format (a subset of the ISO 8601 timestamp format).

§Examples
use tracing_subscriber::fmt::{self, time};

let collector = tracing_subscriber::fmt()
    .with_timer(time::LocalTime::rfc_3339());
Source§

impl<F: Formattable> LocalTime<F>

Source

pub fn new(format: F) -> Self

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

    Warning: The 
    time crate must be compiled with --cfg
    unsound_local_offset in order to use local timestamps. When this
    cfg is not enabled, local timestamps cannot be recorded, and
    events will be logged without timestamps.

See the time documentation for more details.

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, throwing 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::LocalTime};
use time::macros::format_description;

let timer = LocalTime::new(format_description!("[hour]:[minute]:[second]"));
let collector = tracing_subscriber::fmt()
    .with_timer(timer);

Using time::format_description::parse:

use tracing_subscriber::fmt::{self, time::LocalTime};

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

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

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

use tracing_subscriber::fmt::{self, time::LocalTime};

let timer = LocalTime::new(time::format_description::well_known::Rfc3339);
let collector = tracing_subscriber::fmt()
    .with_timer(timer);

Trait Implementations§

Source§

impl<F: Clone> Clone for LocalTime<F>

Source§

fn clone(&self) -> LocalTime<F>

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<F: Debug> Debug for LocalTime<F>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<F> Default for LocalTime<F>
where F: Formattable + Default,

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<F> FormatTime for LocalTime<F>
where F: Formattable,

Source§

fn format_time(&self, w: &mut Writer<'_>) -> Result

Measure and write out the current time. Read more

Auto Trait Implementations§

§

impl<F> Freeze for LocalTime<F>
where F: Freeze,

§

impl<F> RefUnwindSafe for LocalTime<F>
where F: RefUnwindSafe,

§

impl<F> Send for LocalTime<F>
where F: Send,

§

impl<F> Sync for LocalTime<F>
where F: Sync,

§

impl<F> Unpin for LocalTime<F>
where F: Unpin,

§

impl<F> UnwindSafe for LocalTime<F>
where F: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit #126799)
Performs copy-assignment from self to dst. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithCollector for T

Source§

fn with_collector<C>(self, collector: C) -> WithDispatch<Self>
where C: Into<Dispatch>,

Attaches the provided collector to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_collector(self) -> WithDispatch<Self>

Attaches the current default collector to this type, returning a WithDispatch wrapper. Read more