time 0.3.48

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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184

use std::fmt::Display;
use std::io;
use std::marker::PhantomData;

use rstest::rstest;
use time::error::{
    ComponentRange, ConversionRange, DifferentVariant, Error, Format, IndeterminateOffset,
    InvalidFormatDescription, InvalidVariant, Parse, ParseFromDescription, TryFromParsed,
};
use time::macros::format_description;
use time::parsing::Parsed;
use time::{Date, Time, format_description};

fn component_range() -> ComponentRange {
    Date::from_ordinal_date(0, 367).expect_err("367 is not a valid day")
}

fn insufficient_type_information() -> Format {
    Time::MIDNIGHT
        .format(format_description!("[year]"))
        .expect_err("missing date and UTC offset")
}

fn unexpected_trailing_characters() -> Parse {
    Time::parse("a", format_description!("")).expect_err("should fail to parse")
}

fn invalid_format_description() -> InvalidFormatDescription {
    format_description::parse_borrowed::<3>("[").expect_err("format description is invalid")
}

fn io_error() -> io::Error {
    io::Error::last_os_error()
}

fn invalid_literal() -> ParseFromDescription {
    Parsed::parse_literal(b"a", b"b").expect_err("should fail to parse")
}

#[rstest]
#[case(Parse::from(ParseFromDescription::InvalidComponent("a")))]
#[case(invalid_format_description())]
#[case(DifferentVariant)]
#[case(InvalidVariant)]
fn debug_reflexive<T>(#[case] value: T)
where
    T: std::fmt::Debug,
{
    assert_eq!(format!("{value:?}"), format!("{value:?}"))
}

#[rstest]
#[case(ConversionRange, Error::from(ConversionRange))]
#[case(component_range(), Error::from(component_range()))]
#[case(component_range(), TryFromParsed::from(component_range()))]
#[case(IndeterminateOffset, Error::from(IndeterminateOffset))]
#[case(
    TryFromParsed::InsufficientInformation,
    Error::from(TryFromParsed::InsufficientInformation)
)]
#[case(
    insufficient_type_information(),
    Error::from(insufficient_type_information())
)]
#[case(
    Format::InvalidComponent("a"),
    Error::from(Format::InvalidComponent("a"))
)]
#[case(
    ParseFromDescription::InvalidComponent("a"),
    Error::from(Parse::from(ParseFromDescription::InvalidComponent("a")))
)]
#[case(invalid_literal(), Parse::from(invalid_literal()))]
#[case(
    component_range(),
    Error::from(Parse::from(TryFromParsed::from(component_range())))
)]
#[case(
    ParseFromDescription::InvalidComponent("a"),
    Parse::from(ParseFromDescription::InvalidComponent("a"))
)]
#[case(component_range(), Parse::from(TryFromParsed::from(component_range())))]
#[case(
    unexpected_trailing_characters(),
    Error::from(unexpected_trailing_characters())
)]
#[case(
    invalid_format_description(),
    Error::from(invalid_format_description())
)]
#[case(io_error(), Format::from(io_error()))]
#[case(DifferentVariant, Error::from(DifferentVariant))]
#[case(InvalidVariant, Error::from(InvalidVariant))]
fn display_eq<T, U>(#[case] lhs: T, #[case] rhs: U)
where
    T: Display,
    U: Display,
{
    assert_eq!(lhs.to_string(), rhs.to_string());
}

#[rstest]
#[case(Error::from(ConversionRange), PhantomData::<ConversionRange>)]
#[case(Error::from(component_range()), PhantomData::<ComponentRange>)]
#[case(TryFromParsed::from(component_range()), PhantomData::<ComponentRange>)]
#[case(Error::from(insufficient_type_information()), PhantomData::<Format>)]
#[case(Error::from(IndeterminateOffset), PhantomData::<IndeterminateOffset>)]
#[case(Parse::from(TryFromParsed::InsufficientInformation), PhantomData::<TryFromParsed>)]
#[case(Error::from(TryFromParsed::InsufficientInformation), PhantomData::<TryFromParsed>)]
#[case(Parse::from(ParseFromDescription::InvalidComponent("a")), PhantomData::<ParseFromDescription>)]
#[case(Error::from(ParseFromDescription::InvalidComponent("a")), PhantomData::<ParseFromDescription>)]
#[case(unexpected_trailing_characters(), PhantomData::<ParseFromDescription>)]
#[case(Error::from(unexpected_trailing_characters()), PhantomData::<ParseFromDescription>)]
#[case(Error::from(invalid_format_description()), PhantomData::<InvalidFormatDescription>)]
#[case(Format::from(io_error()), PhantomData::<io::Error>)]
#[case(Error::from(DifferentVariant), PhantomData::<DifferentVariant>)]
#[case(Error::from(InvalidVariant), PhantomData::<InvalidVariant>)]
fn source<E, S>(#[case] err: E, #[case] _source: PhantomData<S>)
where
    E: std::error::Error + 'static,
    S: std::error::Error + 'static,
{
    assert!(
        err.source()
            .expect("error type should have source")
            .is::<S>()
    );
}

#[rstest]
#[case(TryFromParsed::InsufficientInformation)]
#[case(insufficient_type_information())]
#[case(Format::InvalidComponent("a"))]
fn source_none<T>(#[case] err: T)
where
    T: std::error::Error,
{
    assert!(err.source().is_none());
}

#[rstest]
fn component_name() {
    assert_eq!(component_range().name(), "ordinal");
}

#[rstest]
#[case(ComponentRange::try_from(Error::from(component_range())))]
#[case(ConversionRange::try_from(Error::from(ConversionRange)))]
#[case(Format::try_from(Error::from(insufficient_type_information())))]
#[case(IndeterminateOffset::try_from(Error::from(IndeterminateOffset)))]
#[case(InvalidFormatDescription::try_from(Error::from(invalid_format_description())))]
#[case(ParseFromDescription::try_from(Error::from(invalid_literal())))]
#[case(ParseFromDescription::try_from(Parse::from(invalid_literal())))]
#[case(ParseFromDescription::try_from(unexpected_trailing_characters()))]
#[case(Parse::try_from(Error::from(unexpected_trailing_characters())))]
#[case(Parse::try_from(Error::from(invalid_literal())))]
#[case(Parse::try_from(Error::from(TryFromParsed::InsufficientInformation)))]
#[case(DifferentVariant::try_from(Error::from(DifferentVariant)))]
#[case(InvalidVariant::try_from(Error::from(InvalidVariant)))]
#[case(ComponentRange::try_from(TryFromParsed::ComponentRange(component_range())))]
#[case(TryFromParsed::try_from(Error::from(TryFromParsed::InsufficientInformation)))]
#[case(TryFromParsed::try_from(Parse::from(TryFromParsed::InsufficientInformation)))]
#[case(io::Error::try_from(Format::from(io_error())))]
fn conversion<T, E>(#[case] res: Result<T, E>) {
    assert!(res.is_ok());
}

#[rstest]
#[case(ComponentRange::try_from(Error::from(IndeterminateOffset)))]
#[case(ConversionRange::try_from(Error::from(IndeterminateOffset)))]
#[case(Format::try_from(Error::from(IndeterminateOffset)))]
#[case(IndeterminateOffset::try_from(Error::from(ConversionRange)))]
#[case(InvalidFormatDescription::try_from(Error::from(IndeterminateOffset)))]
#[case(ParseFromDescription::try_from(Error::from(IndeterminateOffset)))]
#[case(Parse::try_from(Error::from(IndeterminateOffset)))]
#[case(DifferentVariant::try_from(Error::from(IndeterminateOffset)))]
#[case(InvalidVariant::try_from(Error::from(IndeterminateOffset)))]
#[case(ComponentRange::try_from(TryFromParsed::InsufficientInformation))]
#[case(TryFromParsed::try_from(Error::from(IndeterminateOffset)))]
#[case(TryFromParsed::try_from(unexpected_trailing_characters()))]
#[case(io::Error::try_from(insufficient_type_information()))]
fn conversion_err<T, E>(#[case] res: Result<T, E>) {
    assert!(res.is_err());
}