Function strftime::fmt::strftime

source · 
pub fn strftime(
    time: &impl Time,
    format: &str,
    buf: &mut dyn Write
) -> Result<(), Error>
Expand description

Format a time implementation with the specified UTF-8 format string, writing to the provided core::fmt::Write object.

See the crate-level documentation for a complete description of possible format specifiers.

§Allocations

This strftime implementation makes no heap allocations on its own, but the provided writer may allocate.

§Examples

use strftime::fmt::strftime;
use strftime::Time;

// Not shown: create a time implementation with the year 1970
// let time = ...;
assert_eq!(time.year(), 1970);

let mut buf = String::new();
strftime(&time, "%Y", &mut buf)?;
assert_eq!(buf, "1970");

§Errors

Can produce an Error when the formatting fails.