From c44de1d38874adb99cdb28c63bb17b4543148677 Mon Sep 17 00:00:00 2001 From: Tom Gallacher Date: Thu, 3 Sep 2015 13:53:18 +0100 Subject: [PATCH] Updating docs --- src/format/strftime.rs | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/src/format/strftime.rs b/src/format/strftime.rs index 0efd8d6..c9c4728 100644 --- a/src/format/strftime.rs +++ b/src/format/strftime.rs @@ -56,6 +56,9 @@ Spec. | Example | Description `%S` | `60` | Second number (00--60), zero-padded to 2 digits. [5] `%f` | `026490000` | The fractional seconds (in nanoseconds) since last whole second. [8] `%.f` | `.026490` | Similar to `.%f` but left-aligned. [8] +`%.3f`| `.026` | Similar to `.%f` but left-aligned but fixed to a length of 3. [8] +`%.6f`| `.026490` | Similar to `.%f` but left-aligned but fixed to a length of 6. [8] +`%.9f`| `.026490000` | Similar to `.%f` but left-aligned but fixed to a length of 9. [8] | | `%R` | `00:34` | Hour-minute format. Same to `%H:%M`. `%T` | `00:34:60` | Hour-minute-second format. Same to `%H:%M:%S`. @@ -115,7 +118,7 @@ Notes: For the purpose of Chrono, it only accounts for non-leap seconds so it slightly differs from ISO C `strftime` behavior. -8. `%f`, `%.f`: +8. `%f`, `%.f`, `%.3f`, `%.6f`, `%.9f`: The default `%f` is right-aligned and always zero-padded to 9 digits for the compatibility with glibc and others, @@ -128,6 +131,12 @@ Notes: Note that they can print or read nothing if the fractional part is zero or the next character is not `.`. + The variant `%.3f`, `%.3f` and `%.3f` are left-aligned and print 3, 6 or 9 fractional digits + according to the number preceding `f`. E.g. 70ms after the last second under `%.3f` will print `.070` + (note: not `.07`), and parsing `.07`, `.070000` etc. will yield the same. + Note that they can read nothing if the fractional part is zero or + the next character is not `.` however will print with the specified length. + */ use super::{Item, Numeric, Fixed, Pad};