itsscb/chrono
1
0
Fork 0
mirror of https://github.com/chronotope/chrono.git synced 2025-10-02 07:21:41 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document Duration's Display format (#517)

Browse Source
This commit is contained in:
Brandon W Maister 2021-01-22 12:12:23 -05:00 committed by GitHub
parent 2b53360471
commit 19ec092d3a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
src/oldtime.rs
View File

@ -45,6 +45,7 @@ macro_rules! try_opt {
} }
/// ISO 8601 time duration with nanosecond precision. /// ISO 8601 time duration with nanosecond precision.
///
/// This also allows for the negative duration; see individual methods for details. /// This also allows for the negative duration; see individual methods for details.
#[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Debug)] #[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Debug)]
pub struct Duration { pub struct Duration {
@ -373,6 +374,9 @@ impl Div<i32> for Duration {
} }
impl fmt::Display for Duration { impl fmt::Display for Duration {
/// Format a duration using the [ISO 8601] format
///
/// [ISO 8601]: https://en.wikipedia.org/wiki/ISO_8601#Durations
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
// technically speaking, negative duration is not valid ISO 8601, // technically speaking, negative duration is not valid ISO 8601,
// but we need to print it anyway. // but we need to print it anyway.