Coverage Report

Created: 2024-12-17 06:15

/rust/registry/src/index.crates.io-6f17d22bba15001f/time-0.3.37/src/parsing/iso8601.rs
Line
Count
Source (jump to first uncovered line)
1
//! Parse parts of an ISO 8601-formatted value.
2
3
use num_conv::prelude::*;
4
5
use crate::convert::*;
6
use crate::error;
7
use crate::error::ParseFromDescription::{InvalidComponent, InvalidLiteral};
8
use crate::format_description::well_known::iso8601::EncodedConfig;
9
use crate::format_description::well_known::Iso8601;
10
use crate::parsing::combinator::rfc::iso8601::{
11
    day, dayk, dayo, float, hour, min, month, week, year, ExtendedKind,
12
};
13
use crate::parsing::combinator::{ascii_char, sign};
14
use crate::parsing::{Parsed, ParsedItem};
15
16
impl<const CONFIG: EncodedConfig> Iso8601<CONFIG> {
17
    // Basic: [year][month][day]
18
    // Extended: [year]["-"][month]["-"][day]
19
    // Basic: [year][dayo]
20
    // Extended: [year]["-"][dayo]
21
    // Basic: [year]["W"][week][dayk]
22
    // Extended: [year]["-"]["W"][week]["-"][dayk]
23
    /// Parse a date in the basic or extended format. Reduced precision is permitted.
24
0
    pub(crate) fn parse_date<'a>(
25
0
        parsed: &'a mut Parsed,
26
0
        extended_kind: &'a mut ExtendedKind,
27
0
    ) -> impl FnMut(&[u8]) -> Result<&[u8], error::Parse> + 'a {
28
0
        move |input| {
29
            // Same for any acceptable format.
30
0
            let ParsedItem(mut input, year) = year(input).ok_or(InvalidComponent("year"))?;
31
0
            *extended_kind = match ascii_char::<b'-'>(input) {
32
0
                Some(ParsedItem(new_input, ())) => {
33
0
                    input = new_input;
34
0
                    ExtendedKind::Extended
35
                }
36
0
                None => ExtendedKind::Basic, // no separator before mandatory month/ordinal/week
37
            };
38
39
0
            let parsed_month_day = (|| {
40
0
                let ParsedItem(mut input, month) = month(input).ok_or(InvalidComponent("month"))?;
41
0
                if extended_kind.is_extended() {
42
0
                    input = ascii_char::<b'-'>(input)
43
0
                        .ok_or(InvalidLiteral)?
44
0
                        .into_inner();
45
0
                }
46
0
                let ParsedItem(input, day) = day(input).ok_or(InvalidComponent("day"))?;
47
0
                Ok(ParsedItem(input, (month, day)))
48
0
            })();
49
0
            let mut ret_error = match parsed_month_day {
50
0
                Ok(ParsedItem(input, (month, day))) => {
51
0
                    *parsed = parsed
52
0
                        .with_year(year)
53
0
                        .ok_or(InvalidComponent("year"))?
54
0
                        .with_month(month)
55
0
                        .ok_or(InvalidComponent("month"))?
56
0
                        .with_day(day)
57
0
                        .ok_or(InvalidComponent("day"))?;
58
0
                    return Ok(input);
59
                }
60
0
                Err(err) => err,
61
            };
62
63
            // Don't check for `None`, as the error from year-month-day will always take priority.
64
0
            if let Some(ParsedItem(input, ordinal)) = dayo(input) {
65
0
                *parsed = parsed
66
0
                    .with_year(year)
67
0
                    .ok_or(InvalidComponent("year"))?
68
0
                    .with_ordinal(ordinal)
69
0
                    .ok_or(InvalidComponent("ordinal"))?;
70
0
                return Ok(input);
71
0
            }
72
0
73
0
            let parsed_week_weekday = (|| {
74
0
                let input = ascii_char::<b'W'>(input)
75
0
                    .ok_or((false, InvalidLiteral))?
76
0
                    .into_inner();
77
0
                let ParsedItem(mut input, week) =
78
0
                    week(input).ok_or((true, InvalidComponent("week")))?;
79
0
                if extended_kind.is_extended() {
80
0
                    input = ascii_char::<b'-'>(input)
81
0
                        .ok_or((true, InvalidLiteral))?
82
0
                        .into_inner();
83
0
                }
84
0
                let ParsedItem(input, weekday) =
85
0
                    dayk(input).ok_or((true, InvalidComponent("weekday")))?;
86
0
                Ok(ParsedItem(input, (week, weekday)))
87
0
            })();
88
0
            match parsed_week_weekday {
89
0
                Ok(ParsedItem(input, (week, weekday))) => {
90
0
                    *parsed = parsed
91
0
                        .with_iso_year(year)
92
0
                        .ok_or(InvalidComponent("year"))?
93
0
                        .with_iso_week_number(week)
94
0
                        .ok_or(InvalidComponent("week"))?
95
0
                        .with_weekday(weekday)
96
0
                        .ok_or(InvalidComponent("weekday"))?;
97
0
                    return Ok(input);
98
                }
99
0
                Err((false, _err)) => {}
100
                // This error is more accurate than the one from year-month-day.
101
0
                Err((true, err)) => ret_error = err,
102
            }
103
104
0
            Err(ret_error.into())
105
0
        }
106
0
    }
107
108
    // Basic: ["T"][hour][min][sec]
109
    // Extended: ["T"][hour][":"][min][":"][sec]
110
    // Reduced precision: components after [hour] (including their preceding separator) can be
111
    // omitted. ["T"] can be omitted if there is no date present.
112
    /// Parse a time in the basic or extended format. Reduced precision is permitted.
113
0
    pub(crate) fn parse_time<'a>(
114
0
        parsed: &'a mut Parsed,
115
0
        extended_kind: &'a mut ExtendedKind,
116
0
        date_is_present: bool,
117
0
    ) -> impl FnMut(&[u8]) -> Result<&[u8], error::Parse> + 'a {
118
0
        move |mut input| {
119
0
            if date_is_present {
120
0
                input = ascii_char::<b'T'>(input)
121
0
                    .ok_or(InvalidLiteral)?
122
0
                    .into_inner();
123
0
            }
124
125
0
            let ParsedItem(mut input, hour) = float(input).ok_or(InvalidComponent("hour"))?;
126
0
            match hour {
127
0
                (hour, None) => parsed.set_hour_24(hour).ok_or(InvalidComponent("hour"))?,
128
0
                (hour, Some(fractional_part)) => {
129
0
                    *parsed = parsed
130
0
                        .with_hour_24(hour)
131
0
                        .ok_or(InvalidComponent("hour"))?
132
0
                        .with_minute((fractional_part * Second::per(Minute) as f64) as _)
133
0
                        .ok_or(InvalidComponent("minute"))?
134
0
                        .with_second(
135
0
                            (fractional_part * Second::per(Hour) as f64 % Minute::per(Hour) as f64)
136
0
                                as _,
137
0
                        )
138
0
                        .ok_or(InvalidComponent("second"))?
139
0
                        .with_subsecond(
140
0
                            (fractional_part * Nanosecond::per(Hour) as f64
141
0
                                % Nanosecond::per(Second) as f64) as _,
142
0
                        )
143
0
                        .ok_or(InvalidComponent("subsecond"))?;
144
0
                    return Ok(input);
145
                }
146
            };
147
148
0
            if let Some(ParsedItem(new_input, ())) = ascii_char::<b':'>(input) {
149
0
                extended_kind
150
0
                    .coerce_extended()
151
0
                    .ok_or(InvalidComponent("minute"))?;
152
0
                input = new_input;
153
0
            };
154
155
0
            let mut input = match float(input) {
156
0
                Some(ParsedItem(input, (minute, None))) => {
157
0
                    extended_kind.coerce_basic();
158
0
                    parsed
159
0
                        .set_minute(minute)
160
0
                        .ok_or(InvalidComponent("minute"))?;
161
0
                    input
162
                }
163
0
                Some(ParsedItem(input, (minute, Some(fractional_part)))) => {
164
0
                    // `None` is valid behavior, so don't error if this fails.
165
0
                    extended_kind.coerce_basic();
166
0
                    *parsed = parsed
167
0
                        .with_minute(minute)
168
0
                        .ok_or(InvalidComponent("minute"))?
169
0
                        .with_second((fractional_part * Second::per(Minute) as f64) as _)
170
0
                        .ok_or(InvalidComponent("second"))?
171
0
                        .with_subsecond(
172
0
                            (fractional_part * Nanosecond::per(Minute) as f64
173
0
                                % Nanosecond::per(Second) as f64) as _,
174
0
                        )
175
0
                        .ok_or(InvalidComponent("subsecond"))?;
176
0
                    return Ok(input);
177
                }
178
                // colon was present, so minutes are required
179
0
                None if extended_kind.is_extended() => {
180
0
                    return Err(error::Parse::ParseFromDescription(InvalidComponent(
181
0
                        "minute",
182
0
                    )));
183
                }
184
                None => {
185
                    // Missing components are assumed to be zero.
186
0
                    *parsed = parsed
187
0
                        .with_minute(0)
188
0
                        .ok_or(InvalidComponent("minute"))?
189
0
                        .with_second(0)
190
0
                        .ok_or(InvalidComponent("second"))?
191
0
                        .with_subsecond(0)
192
0
                        .ok_or(InvalidComponent("subsecond"))?;
193
0
                    return Ok(input);
194
                }
195
            };
196
197
0
            if extended_kind.is_extended() {
198
0
                match ascii_char::<b':'>(input) {
199
0
                    Some(ParsedItem(new_input, ())) => input = new_input,
200
                    None => {
201
0
                        *parsed = parsed
202
0
                            .with_second(0)
203
0
                            .ok_or(InvalidComponent("second"))?
204
0
                            .with_subsecond(0)
205
0
                            .ok_or(InvalidComponent("subsecond"))?;
206
0
                        return Ok(input);
207
                    }
208
                }
209
0
            }
210
211
0
            let (input, second, subsecond) = match float(input) {
212
0
                Some(ParsedItem(input, (second, None))) => (input, second, 0),
213
0
                Some(ParsedItem(input, (second, Some(fractional_part)))) => (
214
0
                    input,
215
0
                    second,
216
0
                    round(fractional_part * Nanosecond::per(Second) as f64) as _,
217
0
                ),
218
0
                None if extended_kind.is_extended() => {
219
0
                    return Err(error::Parse::ParseFromDescription(InvalidComponent(
220
0
                        "second",
221
0
                    )));
222
                }
223
                // Missing components are assumed to be zero.
224
0
                None => (input, 0, 0),
225
            };
226
0
            *parsed = parsed
227
0
                .with_second(second)
228
0
                .ok_or(InvalidComponent("second"))?
229
0
                .with_subsecond(subsecond)
230
0
                .ok_or(InvalidComponent("subsecond"))?;
231
232
0
            Ok(input)
233
0
        }
234
0
    }
235
236
    // Basic: [±][hour][min] or ["Z"]
237
    // Extended: [±][hour][":"][min] or ["Z"]
238
    // Reduced precision: [±][hour] or ["Z"]
239
    /// Parse a UTC offset in the basic or extended format. Reduced precision is supported.
240
0
    pub(crate) fn parse_offset<'a>(
241
0
        parsed: &'a mut Parsed,
242
0
        extended_kind: &'a mut ExtendedKind,
243
0
    ) -> impl FnMut(&[u8]) -> Result<&[u8], error::Parse> + 'a {
244
0
        move |input| {
245
0
            if let Some(ParsedItem(input, ())) = ascii_char::<b'Z'>(input) {
246
0
                *parsed = parsed
247
0
                    .with_offset_hour(0)
248
0
                    .ok_or(InvalidComponent("offset hour"))?
249
0
                    .with_offset_minute_signed(0)
250
0
                    .ok_or(InvalidComponent("offset minute"))?
251
0
                    .with_offset_second_signed(0)
252
0
                    .ok_or(InvalidComponent("offset second"))?;
253
0
                return Ok(input);
254
0
            }
255
256
0
            let ParsedItem(input, sign) = sign(input).ok_or(InvalidComponent("offset hour"))?;
257
0
            let mut input = hour(input)
258
0
                .and_then(|parsed_item| {
259
0
                    parsed_item.consume_value(|hour| {
260
0
                        parsed.set_offset_hour(if sign == b'-' {
261
0
                            -hour.cast_signed()
262
                        } else {
263
0
                            hour.cast_signed()
264
                        })
265
0
                    })
266
0
                })
267
0
                .ok_or(InvalidComponent("offset hour"))?;
268
269
0
            if extended_kind.maybe_extended() {
270
0
                if let Some(ParsedItem(new_input, ())) = ascii_char::<b':'>(input) {
271
0
                    extended_kind
272
0
                        .coerce_extended()
273
0
                        .ok_or(InvalidComponent("offset minute"))?;
274
0
                    input = new_input;
275
0
                };
276
0
            }
277
278
0
            match min(input) {
279
0
                Some(ParsedItem(new_input, min)) => {
280
0
                    input = new_input;
281
0
                    parsed
282
0
                        .set_offset_minute_signed(if sign == b'-' {
283
0
                            -min.cast_signed()
284
                        } else {
285
0
                            min.cast_signed()
286
                        })
287
0
                        .ok_or(InvalidComponent("offset minute"))?;
288
                }
289
0
                None => {
290
0
                    // Omitted offset minute is assumed to be zero.
291
0
                    parsed.set_offset_minute_signed(0);
292
0
                }
293
            }
294
295
            // If `:` was present, the format has already been set to extended. As such, this call
296
            // will do nothing in that case. If there wasn't `:` but minutes were
297
            // present, we know it's the basic format. Do not use `?` on the call, as
298
            // returning `None` is valid behavior.
299
0
            extended_kind.coerce_basic();
300
0
301
0
            Ok(input)
302
0
        }
303
0
    }
304
}
305
306
/// Round wrapper that uses hardware implementation if `std` is available, falling back to manual
307
/// implementation for `no_std`
308
0
fn round(value: f64) -> f64 {
309
0
    #[cfg(feature = "std")]
310
0
    {
311
0
        value.round()
312
0
    }
313
0
    #[cfg(not(feature = "std"))]
314
0
    {
315
0
        round_impl(value)
316
0
    }
317
0
}
318
319
#[cfg(not(feature = "std"))]
320
#[allow(clippy::missing_docs_in_private_items)]
321
fn round_impl(value: f64) -> f64 {
322
    debug_assert!(value.is_sign_positive() && !value.is_nan());
323
324
    let f = value % 1.;
325
    if f < 0.5 {
326
        value - f
327
    } else {
328
        value - f + 1.
329
    }
330
}