time 0.2.13

Date and time library. Fully interoperable with the standard library. Mostly compatible with #![no_std].
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! The `DeferredFormat` struct, acting as an intermediary between a request to
//! format and the final output.

use crate::{
    format::{format_specifier, parse_fmt_string, well_known, Format, FormatItem},
    internal_prelude::*,
};
use core::fmt::{self, Display, Formatter};

/// A struct containing all the necessary information to display the inner type.
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub(crate) struct DeferredFormat {
    /// The `Date` to use for formatting.
    date: Option<Date>,
    /// The `Time` to use for formatting.
    time: Option<Time>,
    /// The `UtcOffset` to use for formatting.
    offset: Option<UtcOffset>,
    /// The list of items used to display the item.
    format: Format,
}

impl DeferredFormat {
    /// Create a new `DeferredFormat` with the provided formatting string.
    #[inline]
    pub(crate) fn new(format: impl Into<Format>) -> Self {
        Self {
            date: None,
            time: None,
            offset: None,
            format: format.into(),
        }
    }

    /// Provide the `Date` component.
    #[inline]
    pub(crate) fn with_date(&mut self, date: Date) -> &mut Self {
        self.date = Some(date);
        self
    }

    /// Provide the `Time` component.
    #[inline]
    pub(crate) fn with_time(&mut self, time: Time) -> &mut Self {
        self.time = Some(time);
        self
    }

    /// Provide the `UtcOffset` component.
    #[inline]
    pub(crate) fn with_offset(&mut self, offset: UtcOffset) -> &mut Self {
        self.offset = Some(offset);
        self
    }

    /// Obtain the `Date` component.
    #[inline(always)]
    pub(crate) const fn date(&self) -> Option<Date> {
        self.date
    }

    /// Obtain the `Time` component.
    #[inline(always)]
    pub(crate) const fn time(&self) -> Option<Time> {
        self.time
    }

    /// Obtain the `UtcOffset` component.
    #[inline(always)]
    pub(crate) const fn offset(&self) -> Option<UtcOffset> {
        self.offset
    }
}

impl Display for DeferredFormat {
    #[inline(always)]
    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
        match &self.format {
            Format::Custom(s) => {
                for item in parse_fmt_string(s) {
                    match item {
                        FormatItem::Literal(value) => f.write_str(value)?,
                        FormatItem::Specifier(specifier) => {
                            format_specifier(f, self.date, self.time, self.offset, specifier)?
                        }
                    }
                }

                Ok(())
            }
            Format::Rfc3339 => well_known::rfc3339::fmt(self, f),
            #[cfg(not(supports_non_exhaustive))]
            Format::__NonExhaustive => unreachable!(),
        }
    }
}