chrono/format/
parse.rs

1// This is a part of Chrono.
2// Portions copyright (c) 2015, John Nagle.
3// See README.md and LICENSE.txt for details.
4
5//! Date and time parsing routines.
6
7use core::borrow::Borrow;
8use core::str;
9use core::usize;
10
11use super::scan;
12use super::{Fixed, InternalFixed, InternalInternal, Item, Numeric, Pad, Parsed};
13use super::{ParseError, ParseErrorKind, ParseResult};
14use super::{BAD_FORMAT, INVALID, NOT_ENOUGH, OUT_OF_RANGE, TOO_LONG, TOO_SHORT};
15use crate::{DateTime, FixedOffset, Weekday};
16
17fn set_weekday_with_num_days_from_sunday(p: &mut Parsed, v: i64) -> ParseResult<()> {
18    p.set_weekday(match v {
19        0 => Weekday::Sun,
20        1 => Weekday::Mon,
21        2 => Weekday::Tue,
22        3 => Weekday::Wed,
23        4 => Weekday::Thu,
24        5 => Weekday::Fri,
25        6 => Weekday::Sat,
26        _ => return Err(OUT_OF_RANGE),
27    })
28}
29
30fn set_weekday_with_number_from_monday(p: &mut Parsed, v: i64) -> ParseResult<()> {
31    p.set_weekday(match v {
32        1 => Weekday::Mon,
33        2 => Weekday::Tue,
34        3 => Weekday::Wed,
35        4 => Weekday::Thu,
36        5 => Weekday::Fri,
37        6 => Weekday::Sat,
38        7 => Weekday::Sun,
39        _ => return Err(OUT_OF_RANGE),
40    })
41}
42
43fn parse_rfc2822<'a>(parsed: &mut Parsed, mut s: &'a str) -> ParseResult<(&'a str, ())> {
44    macro_rules! try_consume {
45        ($e:expr) => {{
46            let (s_, v) = $e?;
47            s = s_;
48            v
49        }};
50    }
51
52    // an adapted RFC 2822 syntax from Section 3.3 and 4.3:
53    //
54    // c-char      = <any char except '(', ')' and '\\'>
55    // c-escape    = "\" <any char>
56    // comment     = "(" *(comment / c-char / c-escape) ")" *S
57    // date-time   = [ day-of-week "," ] date 1*S time *S *comment
58    // day-of-week = *S day-name *S
59    // day-name    = "Mon" / "Tue" / "Wed" / "Thu" / "Fri" / "Sat" / "Sun"
60    // date        = day month year
61    // day         = *S 1*2DIGIT *S
62    // month       = 1*S month-name 1*S
63    // month-name  = "Jan" / "Feb" / "Mar" / "Apr" / "May" / "Jun" /
64    //               "Jul" / "Aug" / "Sep" / "Oct" / "Nov" / "Dec"
65    // year        = *S 2*DIGIT *S
66    // time        = time-of-day 1*S zone
67    // time-of-day = hour ":" minute [ ":" second ]
68    // hour        = *S 2DIGIT *S
69    // minute      = *S 2DIGIT *S
70    // second      = *S 2DIGIT *S
71    // zone        = ( "+" / "-" ) 4DIGIT /
72    //               "UT" / "GMT" /                  ; same as +0000
73    //               "EST" / "CST" / "MST" / "PST" / ; same as -0500 to -0800
74    //               "EDT" / "CDT" / "MDT" / "PDT" / ; same as -0400 to -0700
75    //               1*(%d65-90 / %d97-122)          ; same as -0000
76    //
77    // some notes:
78    //
79    // - quoted characters can be in any mixture of lower and upper cases.
80    //
81    // - we do not recognize a folding white space (FWS) or comment (CFWS).
82    //   for our purposes, instead, we accept any sequence of Unicode
83    //   white space characters (denoted here to `S`). For comments, we accept
84    //   any text within parentheses while respecting escaped parentheses.
85    //   Any actual RFC 2822 parser is expected to parse FWS and/or CFWS themselves
86    //   and replace it with a single SP (`%x20`); this is legitimate.
87    //
88    // - two-digit year < 50 should be interpreted by adding 2000.
89    //   two-digit year >= 50 or three-digit year should be interpreted
90    //   by adding 1900. note that four-or-more-digit years less than 1000
91    //   are *never* affected by this rule.
92    //
93    // - mismatching day-of-week is always an error, which is consistent to
94    //   Chrono's own rules.
95    //
96    // - zones can range from `-9959` to `+9959`, but `FixedOffset` does not
97    //   support offsets larger than 24 hours. this is not *that* problematic
98    //   since we do not directly go to a `DateTime` so one can recover
99    //   the offset information from `Parsed` anyway.
100
101    s = s.trim_start();
102
103    if let Ok((s_, weekday)) = scan::short_weekday(s) {
104        if !s_.starts_with(',') {
105            return Err(INVALID);
106        }
107        s = &s_[1..];
108        parsed.set_weekday(weekday)?;
109    }
110
111    s = s.trim_start();
112    parsed.set_day(try_consume!(scan::number(s, 1, 2)))?;
113    s = scan::space(s)?; // mandatory
114    parsed.set_month(1 + i64::from(try_consume!(scan::short_month0(s))))?;
115    s = scan::space(s)?; // mandatory
116
117    // distinguish two- and three-digit years from four-digit years
118    let prevlen = s.len();
119    let mut year = try_consume!(scan::number(s, 2, usize::MAX));
120    let yearlen = prevlen - s.len();
121    match (yearlen, year) {
122        (2, 0..=49) => {
123            year += 2000;
124        } //   47 -> 2047,   05 -> 2005
125        (2, 50..=99) => {
126            year += 1900;
127        } //   79 -> 1979
128        (3, _) => {
129            year += 1900;
130        } //  112 -> 2012,  009 -> 1909
131        (_, _) => {} // 1987 -> 1987, 0654 -> 0654
132    }
133    parsed.set_year(year)?;
134
135    s = scan::space(s)?; // mandatory
136    parsed.set_hour(try_consume!(scan::number(s, 2, 2)))?;
137    s = scan::char(s.trim_start(), b':')?.trim_start(); // *S ":" *S
138    parsed.set_minute(try_consume!(scan::number(s, 2, 2)))?;
139    if let Ok(s_) = scan::char(s.trim_start(), b':') {
140        // [ ":" *S 2DIGIT ]
141        parsed.set_second(try_consume!(scan::number(s_, 2, 2)))?;
142    }
143
144    s = scan::space(s)?; // mandatory
145    if let Some(offset) = try_consume!(scan::timezone_offset_2822(s)) {
146        // only set the offset when it is definitely known (i.e. not `-0000`)
147        parsed.set_offset(i64::from(offset))?;
148    }
149
150    // optional comments
151    while let Ok((s_out, ())) = scan::comment_2822(s) {
152        s = s_out;
153    }
154
155    Ok((s, ()))
156}
157
158pub(crate) fn parse_rfc3339<'a>(parsed: &mut Parsed, mut s: &'a str) -> ParseResult<(&'a str, ())> {
159    macro_rules! try_consume {
160        ($e:expr) => {{
161            let (s_, v) = $e?;
162            s = s_;
163            v
164        }};
165    }
166
167    // an adapted RFC 3339 syntax from Section 5.6:
168    //
169    // date-fullyear  = 4DIGIT
170    // date-month     = 2DIGIT ; 01-12
171    // date-mday      = 2DIGIT ; 01-28, 01-29, 01-30, 01-31 based on month/year
172    // time-hour      = 2DIGIT ; 00-23
173    // time-minute    = 2DIGIT ; 00-59
174    // time-second    = 2DIGIT ; 00-58, 00-59, 00-60 based on leap second rules
175    // time-secfrac   = "." 1*DIGIT
176    // time-numoffset = ("+" / "-") time-hour ":" time-minute
177    // time-offset    = "Z" / time-numoffset
178    // partial-time   = time-hour ":" time-minute ":" time-second [time-secfrac]
179    // full-date      = date-fullyear "-" date-month "-" date-mday
180    // full-time      = partial-time time-offset
181    // date-time      = full-date "T" full-time
182    //
183    // some notes:
184    //
185    // - quoted characters can be in any mixture of lower and upper cases.
186    //
187    // - it may accept any number of fractional digits for seconds.
188    //   for Chrono, this means that we should skip digits past first 9 digits.
189    //
190    // - unlike RFC 2822, the valid offset ranges from -23:59 to +23:59.
191    //   note that this restriction is unique to RFC 3339 and not ISO 8601.
192    //   since this is not a typical Chrono behavior, we check it earlier.
193    //
194    // - For readability a full-date and a full-time may be separated by a space character.
195
196    parsed.set_year(try_consume!(scan::number(s, 4, 4)))?;
197    s = scan::char(s, b'-')?;
198    parsed.set_month(try_consume!(scan::number(s, 2, 2)))?;
199    s = scan::char(s, b'-')?;
200    parsed.set_day(try_consume!(scan::number(s, 2, 2)))?;
201
202    s = match s.as_bytes().first() {
203        Some(&b't' | &b'T' | &b' ') => &s[1..],
204        Some(_) => return Err(INVALID),
205        None => return Err(TOO_SHORT),
206    };
207
208    parsed.set_hour(try_consume!(scan::number(s, 2, 2)))?;
209    s = scan::char(s, b':')?;
210    parsed.set_minute(try_consume!(scan::number(s, 2, 2)))?;
211    s = scan::char(s, b':')?;
212    parsed.set_second(try_consume!(scan::number(s, 2, 2)))?;
213    if s.starts_with('.') {
214        let nanosecond = try_consume!(scan::nanosecond(&s[1..]));
215        parsed.set_nanosecond(nanosecond)?;
216    }
217
218    let offset = try_consume!(scan::timezone_offset(s, |s| scan::char(s, b':'), true, false, true));
219    if offset <= -86_400 || offset >= 86_400 {
220        return Err(OUT_OF_RANGE);
221    }
222    parsed.set_offset(i64::from(offset))?;
223
224    Ok((s, ()))
225}
226
227/// Tries to parse given string into `parsed` with given formatting items.
228/// Returns `Ok` when the entire string has been parsed (otherwise `parsed` should not be used).
229/// There should be no trailing string after parsing;
230/// use a stray [`Item::Space`](./enum.Item.html#variant.Space) to trim whitespaces.
231///
232/// This particular date and time parser is:
233///
234/// - Greedy. It will consume the longest possible prefix.
235///   For example, `April` is always consumed entirely when the long month name is requested;
236///   it equally accepts `Apr`, but prefers the longer prefix in this case.
237///
238/// - Padding-agnostic (for numeric items).
239///   The [`Pad`](./enum.Pad.html) field is completely ignored,
240///   so one can prepend any number of whitespace then any number of zeroes before numbers.
241///
242/// - (Still) obeying the intrinsic parsing width. This allows, for example, parsing `HHMMSS`.
243pub fn parse<'a, I, B>(parsed: &mut Parsed, s: &str, items: I) -> ParseResult<()>
244where
245    I: Iterator<Item = B>,
246    B: Borrow<Item<'a>>,
247{
248    parse_internal(parsed, s, items).map(|_| ()).map_err(|(_s, e)| e)
249}
250
251/// Tries to parse given string into `parsed` with given formatting items.
252/// Returns `Ok` with a slice of the unparsed remainder.
253///
254/// This particular date and time parser is:
255///
256/// - Greedy. It will consume the longest possible prefix.
257///   For example, `April` is always consumed entirely when the long month name is requested;
258///   it equally accepts `Apr`, but prefers the longer prefix in this case.
259///
260/// - Padding-agnostic (for numeric items).
261///   The [`Pad`](./enum.Pad.html) field is completely ignored,
262///   so one can prepend any number of zeroes before numbers.
263///
264/// - (Still) obeying the intrinsic parsing width. This allows, for example, parsing `HHMMSS`.
265pub fn parse_and_remainder<'a, 'b, I, B>(
266    parsed: &mut Parsed,
267    s: &'b str,
268    items: I,
269) -> ParseResult<&'b str>
270where
271    I: Iterator<Item = B>,
272    B: Borrow<Item<'a>>,
273{
274    match parse_internal(parsed, s, items) {
275        Ok(s) => Ok(s),
276        Err((s, ParseError(ParseErrorKind::TooLong))) => Ok(s),
277        Err((_s, e)) => Err(e),
278    }
279}
280
281fn parse_internal<'a, 'b, I, B>(
282    parsed: &mut Parsed,
283    mut s: &'b str,
284    items: I,
285) -> Result<&'b str, (&'b str, ParseError)>
286where
287    I: Iterator<Item = B>,
288    B: Borrow<Item<'a>>,
289{
290    macro_rules! try_consume {
291        ($e:expr) => {{
292            match $e {
293                Ok((s_, v)) => {
294                    s = s_;
295                    v
296                }
297                Err(e) => return Err((s, e)),
298            }
299        }};
300    }
301
302    for item in items {
303        match *item.borrow() {
304            Item::Literal(prefix) => {
305                if s.len() < prefix.len() {
306                    return Err((s, TOO_SHORT));
307                }
308                if !s.starts_with(prefix) {
309                    return Err((s, INVALID));
310                }
311                s = &s[prefix.len()..];
312            }
313
314            #[cfg(any(feature = "alloc", feature = "std"))]
315            Item::OwnedLiteral(ref prefix) => {
316                if s.len() < prefix.len() {
317                    return Err((s, TOO_SHORT));
318                }
319                if !s.starts_with(&prefix[..]) {
320                    return Err((s, INVALID));
321                }
322                s = &s[prefix.len()..];
323            }
324
325            Item::Space(_) => {
326                s = s.trim_start();
327            }
328
329            #[cfg(any(feature = "alloc", feature = "std"))]
330            Item::OwnedSpace(_) => {
331                s = s.trim_start();
332            }
333
334            Item::Numeric(ref spec, ref _pad) => {
335                use super::Numeric::*;
336                type Setter = fn(&mut Parsed, i64) -> ParseResult<()>;
337
338                let (width, signed, set): (usize, bool, Setter) = match *spec {
339                    Year => (4, true, Parsed::set_year),
340                    YearDiv100 => (2, false, Parsed::set_year_div_100),
341                    YearMod100 => (2, false, Parsed::set_year_mod_100),
342                    IsoYear => (4, true, Parsed::set_isoyear),
343                    IsoYearDiv100 => (2, false, Parsed::set_isoyear_div_100),
344                    IsoYearMod100 => (2, false, Parsed::set_isoyear_mod_100),
345                    Month => (2, false, Parsed::set_month),
346                    Day => (2, false, Parsed::set_day),
347                    WeekFromSun => (2, false, Parsed::set_week_from_sun),
348                    WeekFromMon => (2, false, Parsed::set_week_from_mon),
349                    IsoWeek => (2, false, Parsed::set_isoweek),
350                    NumDaysFromSun => (1, false, set_weekday_with_num_days_from_sunday),
351                    WeekdayFromMon => (1, false, set_weekday_with_number_from_monday),
352                    Ordinal => (3, false, Parsed::set_ordinal),
353                    Hour => (2, false, Parsed::set_hour),
354                    Hour12 => (2, false, Parsed::set_hour12),
355                    Minute => (2, false, Parsed::set_minute),
356                    Second => (2, false, Parsed::set_second),
357                    Nanosecond => (9, false, Parsed::set_nanosecond),
358                    Timestamp => (usize::MAX, false, Parsed::set_timestamp),
359
360                    // for the future expansion
361                    Internal(ref int) => match int._dummy {},
362                };
363
364                s = s.trim_start();
365                let v = if signed {
366                    if s.starts_with('-') {
367                        let v = try_consume!(scan::number(&s[1..], 1, usize::MAX));
368                        0i64.checked_sub(v).ok_or((s, OUT_OF_RANGE))?
369                    } else if s.starts_with('+') {
370                        try_consume!(scan::number(&s[1..], 1, usize::MAX))
371                    } else {
372                        // if there is no explicit sign, we respect the original `width`
373                        try_consume!(scan::number(s, 1, width))
374                    }
375                } else {
376                    try_consume!(scan::number(s, 1, width))
377                };
378                set(parsed, v).map_err(|e| (s, e))?;
379            }
380
381            Item::Fixed(ref spec) => {
382                use super::Fixed::*;
383
384                match spec {
385                    &ShortMonthName => {
386                        let month0 = try_consume!(scan::short_month0(s));
387                        parsed.set_month(i64::from(month0) + 1).map_err(|e| (s, e))?;
388                    }
389
390                    &LongMonthName => {
391                        let month0 = try_consume!(scan::short_or_long_month0(s));
392                        parsed.set_month(i64::from(month0) + 1).map_err(|e| (s, e))?;
393                    }
394
395                    &ShortWeekdayName => {
396                        let weekday = try_consume!(scan::short_weekday(s));
397                        parsed.set_weekday(weekday).map_err(|e| (s, e))?;
398                    }
399
400                    &LongWeekdayName => {
401                        let weekday = try_consume!(scan::short_or_long_weekday(s));
402                        parsed.set_weekday(weekday).map_err(|e| (s, e))?;
403                    }
404
405                    &LowerAmPm | &UpperAmPm => {
406                        if s.len() < 2 {
407                            return Err((s, TOO_SHORT));
408                        }
409                        let ampm = match (s.as_bytes()[0] | 32, s.as_bytes()[1] | 32) {
410                            (b'a', b'm') => false,
411                            (b'p', b'm') => true,
412                            _ => return Err((s, INVALID)),
413                        };
414                        parsed.set_ampm(ampm).map_err(|e| (s, e))?;
415                        s = &s[2..];
416                    }
417
418                    &Nanosecond | &Nanosecond3 | &Nanosecond6 | &Nanosecond9 => {
419                        if s.starts_with('.') {
420                            let nano = try_consume!(scan::nanosecond(&s[1..]));
421                            parsed.set_nanosecond(nano).map_err(|e| (s, e))?;
422                        }
423                    }
424
425                    &Internal(InternalFixed { val: InternalInternal::Nanosecond3NoDot }) => {
426                        if s.len() < 3 {
427                            return Err((s, TOO_SHORT));
428                        }
429                        let nano = try_consume!(scan::nanosecond_fixed(s, 3));
430                        parsed.set_nanosecond(nano).map_err(|e| (s, e))?;
431                    }
432
433                    &Internal(InternalFixed { val: InternalInternal::Nanosecond6NoDot }) => {
434                        if s.len() < 6 {
435                            return Err((s, TOO_SHORT));
436                        }
437                        let nano = try_consume!(scan::nanosecond_fixed(s, 6));
438                        parsed.set_nanosecond(nano).map_err(|e| (s, e))?;
439                    }
440
441                    &Internal(InternalFixed { val: InternalInternal::Nanosecond9NoDot }) => {
442                        if s.len() < 9 {
443                            return Err((s, TOO_SHORT));
444                        }
445                        let nano = try_consume!(scan::nanosecond_fixed(s, 9));
446                        parsed.set_nanosecond(nano).map_err(|e| (s, e))?;
447                    }
448
449                    &TimezoneName => {
450                        try_consume!(Ok((s.trim_start_matches(|c: char| !c.is_whitespace()), ())));
451                    }
452
453                    &TimezoneOffsetColon
454                    | &TimezoneOffsetDoubleColon
455                    | &TimezoneOffsetTripleColon
456                    | &TimezoneOffset => {
457                        let offset = try_consume!(scan::timezone_offset(
458                            s.trim_start(),
459                            scan::colon_or_space,
460                            false,
461                            false,
462                            true,
463                        ));
464                        parsed.set_offset(i64::from(offset)).map_err(|e| (s, e))?;
465                    }
466
467                    &TimezoneOffsetColonZ | &TimezoneOffsetZ => {
468                        let offset = try_consume!(scan::timezone_offset(
469                            s.trim_start(),
470                            scan::colon_or_space,
471                            true,
472                            false,
473                            true,
474                        ));
475                        parsed.set_offset(i64::from(offset)).map_err(|e| (s, e))?;
476                    }
477                    &Internal(InternalFixed {
478                        val: InternalInternal::TimezoneOffsetPermissive,
479                    }) => {
480                        let offset = try_consume!(scan::timezone_offset(
481                            s.trim_start(),
482                            scan::colon_or_space,
483                            true,
484                            true,
485                            true,
486                        ));
487                        parsed.set_offset(i64::from(offset)).map_err(|e| (s, e))?;
488                    }
489
490                    &RFC2822 => try_consume!(parse_rfc2822(parsed, s)),
491                    &RFC3339 => {
492                        // Used for the `%+` specifier, which has the description:
493                        // "Same as `%Y-%m-%dT%H:%M:%S%.f%:z` (...)
494                        // This format also supports having a `Z` or `UTC` in place of `%:z`."
495                        // Use the relaxed parser to match this description.
496                        try_consume!(parse_rfc3339_relaxed(parsed, s))
497                    }
498                }
499            }
500
501            Item::Error => {
502                return Err((s, BAD_FORMAT));
503            }
504        }
505    }
506
507    // if there are trailling chars, it is an error
508    if !s.is_empty() {
509        Err((s, TOO_LONG))
510    } else {
511        Ok(s)
512    }
513}
514
515/// Accepts a relaxed form of RFC3339.
516/// A space or a 'T' are acepted as the separator between the date and time
517/// parts. Additional spaces are allowed between each component.
518///
519/// All of these examples are equivalent:
520/// ```
521/// # use chrono::{DateTime, offset::FixedOffset};
522/// "2012-12-12T12:12:12Z".parse::<DateTime<FixedOffset>>()?;
523/// "2012-12-12 12:12:12Z".parse::<DateTime<FixedOffset>>()?;
524/// "2012-  12-12T12:  12:12Z".parse::<DateTime<FixedOffset>>()?;
525/// # Ok::<(), chrono::ParseError>(())
526/// ```
527impl str::FromStr for DateTime<FixedOffset> {
528    type Err = ParseError;
529
530    fn from_str(s: &str) -> ParseResult<DateTime<FixedOffset>> {
531        let mut parsed = Parsed::new();
532        let (s, _) = parse_rfc3339_relaxed(&mut parsed, s)?;
533        if !s.trim_start().is_empty() {
534            return Err(TOO_LONG);
535        }
536        parsed.to_datetime()
537    }
538}
539
540/// Accepts a relaxed form of RFC3339.
541///
542/// Differences with RFC3339:
543/// - Values don't require padding to two digits.
544/// - Years outside the range 0...=9999 are accepted, but they must include a sign.
545/// - `UTC` is accepted as a valid timezone name/offset (for compatibility with the debug format of
546///   `DateTime<Utc>`.
547/// - There can be spaces between any of the components.
548/// - The colon in the offset may be missing.
549fn parse_rfc3339_relaxed<'a>(parsed: &mut Parsed, mut s: &'a str) -> ParseResult<(&'a str, ())> {
550    const DATE_ITEMS: &[Item<'static>] = &[
551        Item::Numeric(Numeric::Year, Pad::Zero),
552        Item::Space(""),
553        Item::Literal("-"),
554        Item::Numeric(Numeric::Month, Pad::Zero),
555        Item::Space(""),
556        Item::Literal("-"),
557        Item::Numeric(Numeric::Day, Pad::Zero),
558    ];
559    const TIME_ITEMS: &[Item<'static>] = &[
560        Item::Numeric(Numeric::Hour, Pad::Zero),
561        Item::Space(""),
562        Item::Literal(":"),
563        Item::Numeric(Numeric::Minute, Pad::Zero),
564        Item::Space(""),
565        Item::Literal(":"),
566        Item::Numeric(Numeric::Second, Pad::Zero),
567        Item::Fixed(Fixed::Nanosecond),
568        Item::Space(""),
569    ];
570
571    s = match parse_internal(parsed, s, DATE_ITEMS.iter()) {
572        Err((remainder, e)) if e.0 == ParseErrorKind::TooLong => remainder,
573        Err((_s, e)) => return Err(e),
574        Ok(_) => return Err(NOT_ENOUGH),
575    };
576
577    s = match s.as_bytes().first() {
578        Some(&b't' | &b'T' | &b' ') => &s[1..],
579        Some(_) => return Err(INVALID),
580        None => return Err(TOO_SHORT),
581    };
582
583    s = match parse_internal(parsed, s, TIME_ITEMS.iter()) {
584        Err((s, e)) if e.0 == ParseErrorKind::TooLong => s,
585        Err((_s, e)) => return Err(e),
586        Ok(_) => return Err(NOT_ENOUGH),
587    };
588    s = s.trim_start();
589    let (s, offset) = if s.len() >= 3 && "UTC".as_bytes().eq_ignore_ascii_case(&s.as_bytes()[..3]) {
590        (&s[3..], 0)
591    } else {
592        scan::timezone_offset(s, scan::colon_or_space, true, false, true)?
593    };
594    parsed.set_offset(i64::from(offset))?;
595    Ok((s, ()))
596}
597
598#[cfg(test)]
599mod tests {
600    use crate::format::*;
601    use crate::{DateTime, FixedOffset, NaiveDateTime, TimeZone, Timelike, Utc};
602
603    macro_rules! parsed {
604        ($($k:ident: $v:expr),*) => (#[allow(unused_mut)] {
605            let mut expected = Parsed::new();
606            $(expected.$k = Some($v);)*
607            Ok(expected)
608        });
609    }
610
611    #[test]
612    fn test_parse_whitespace_and_literal() {
613        use crate::format::Item::{Literal, Space};
614
615        // empty string
616        parses("", &[]);
617        check(" ", &[], Err(TOO_LONG));
618        check("a", &[], Err(TOO_LONG));
619        check("abc", &[], Err(TOO_LONG));
620        check("🀠", &[], Err(TOO_LONG));
621
622        // whitespaces
623        parses("", &[Space("")]);
624        parses(" ", &[Space(" ")]);
625        parses("  ", &[Space("  ")]);
626        parses("   ", &[Space("   ")]);
627        parses(" ", &[Space("")]);
628        parses("  ", &[Space(" ")]);
629        parses("   ", &[Space("  ")]);
630        parses("    ", &[Space("  ")]);
631        parses("", &[Space(" ")]);
632        parses(" ", &[Space("  ")]);
633        parses("  ", &[Space("   ")]);
634        parses("  ", &[Space("  "), Space("  ")]);
635        parses("   ", &[Space("  "), Space("  ")]);
636        parses("  ", &[Space(" "), Space(" ")]);
637        parses("   ", &[Space("  "), Space(" ")]);
638        parses("   ", &[Space(" "), Space("  ")]);
639        parses("   ", &[Space(" "), Space(" "), Space(" ")]);
640        parses("\t", &[Space("")]);
641        parses(" \n\r  \n", &[Space("")]);
642        parses("\t", &[Space("\t")]);
643        parses("\t", &[Space(" ")]);
644        parses(" ", &[Space("\t")]);
645        parses("\t\r", &[Space("\t\r")]);
646        parses("\t\r ", &[Space("\t\r ")]);
647        parses("\t \r", &[Space("\t \r")]);
648        parses(" \t\r", &[Space(" \t\r")]);
649        parses(" \n\r  \n", &[Space(" \n\r  \n")]);
650        parses(" \t\n", &[Space(" \t")]);
651        parses(" \n\t", &[Space(" \t\n")]);
652        parses("\u{2002}", &[Space("\u{2002}")]);
653        // most unicode whitespace characters
654        parses(
655            "\u{00A0}\u{1680}\u{2000}\u{2001}\u{2002}\u{2003}\u{2004}\u{2005}\u{2006}\u{2007}\u{2008}\u{2009}\u{3000}",
656            &[Space("\u{00A0}\u{1680}\u{2000}\u{2001}\u{2002}\u{2003}\u{2004}\u{2005}\u{2006}\u{2007}\u{2008}\u{2009}\u{3000}")]
657        );
658        // most unicode whitespace characters
659        parses(
660            "\u{00A0}\u{1680}\u{2000}\u{2001}\u{2002}\u{2003}\u{2004}\u{2005}\u{2006}\u{2007}\u{2008}\u{2009}\u{3000}",
661            &[
662                Space("\u{00A0}\u{1680}\u{2000}\u{2001}\u{2002}\u{2003}\u{2004}"),
663                Space("\u{2005}\u{2006}\u{2007}\u{2008}\u{2009}\u{3000}")
664            ]
665        );
666        check("a", &[Space("")], Err(TOO_LONG));
667        check("a", &[Space(" ")], Err(TOO_LONG));
668        // a Space containing a literal does not match a literal
669        check("a", &[Space("a")], Err(TOO_LONG));
670        check("abc", &[Space("")], Err(TOO_LONG));
671        check("abc", &[Space(" ")], Err(TOO_LONG));
672        check(" abc", &[Space("")], Err(TOO_LONG));
673        check(" abc", &[Space(" ")], Err(TOO_LONG));
674
675        // `\u{0363}` is combining diacritic mark "COMBINING LATIN SMALL LETTER A"
676
677        // literal
678        parses("", &[Literal("")]);
679        check("", &[Literal("a")], Err(TOO_SHORT));
680        check(" ", &[Literal("a")], Err(INVALID));
681        parses("a", &[Literal("a")]);
682        parses("+", &[Literal("+")]);
683        parses("-", &[Literal("-")]);
684        parses("βˆ’", &[Literal("βˆ’")]); // MINUS SIGN (U+2212)
685        parses(" ", &[Literal(" ")]); // a Literal may contain whitespace and match whitespace
686        check("aa", &[Literal("a")], Err(TOO_LONG));
687        check("🀠", &[Literal("a")], Err(INVALID));
688        check("A", &[Literal("a")], Err(INVALID));
689        check("a", &[Literal("z")], Err(INVALID));
690        check("a", &[Literal("🀠")], Err(TOO_SHORT));
691        check("a", &[Literal("\u{0363}a")], Err(TOO_SHORT));
692        check("\u{0363}a", &[Literal("a")], Err(INVALID));
693        parses("\u{0363}a", &[Literal("\u{0363}a")]);
694        check("a", &[Literal("ab")], Err(TOO_SHORT));
695        parses("xy", &[Literal("xy")]);
696        parses("xy", &[Literal("x"), Literal("y")]);
697        parses("1", &[Literal("1")]);
698        parses("1234", &[Literal("1234")]);
699        parses("+1234", &[Literal("+1234")]);
700        parses("-1234", &[Literal("-1234")]);
701        parses("βˆ’1234", &[Literal("βˆ’1234")]); // MINUS SIGN (U+2212)
702        parses("PST", &[Literal("PST")]);
703        parses("🀠", &[Literal("🀠")]);
704        parses("🀠a", &[Literal("🀠"), Literal("a")]);
705        parses("🀠a🀠", &[Literal("🀠"), Literal("a🀠")]);
706        parses("a🀠b", &[Literal("a"), Literal("🀠"), Literal("b")]);
707        // literals can be together
708        parses("xy", &[Literal("xy")]);
709        parses("xyz", &[Literal("xyz")]);
710        // or literals can be apart
711        parses("xy", &[Literal("x"), Literal("y")]);
712        parses("xyz", &[Literal("x"), Literal("yz")]);
713        parses("xyz", &[Literal("xy"), Literal("z")]);
714        parses("xyz", &[Literal("x"), Literal("y"), Literal("z")]);
715        //
716        check("x y", &[Literal("x"), Literal("y")], Err(INVALID));
717        parses("xy", &[Literal("x"), Space(""), Literal("y")]);
718        parses("x y", &[Literal("x"), Space(""), Literal("y")]);
719        parses("x y", &[Literal("x"), Space(" "), Literal("y")]);
720
721        // whitespaces + literals
722        parses("a\n", &[Literal("a"), Space("\n")]);
723        parses("\tab\n", &[Space("\t"), Literal("ab"), Space("\n")]);
724        parses(
725            "ab\tcd\ne",
726            &[Literal("ab"), Space("\t"), Literal("cd"), Space("\n"), Literal("e")],
727        );
728        parses(
729            "+1ab\tcd\r\n+,.",
730            &[Literal("+1ab"), Space("\t"), Literal("cd"), Space("\r\n"), Literal("+,.")],
731        );
732        // whitespace and literals can be intermixed
733        parses("a\tb", &[Literal("a\tb")]);
734        parses("a\tb", &[Literal("a"), Space("\t"), Literal("b")]);
735    }
736
737    #[test]
738    fn test_parse_numeric() {
739        use crate::format::Item::{Literal, Space};
740        use crate::format::Numeric::*;
741
742        // numeric
743        check("1987", &[num(Year)], parsed!(year: 1987));
744        check("1987 ", &[num(Year)], Err(TOO_LONG));
745        check("0x12", &[num(Year)], Err(TOO_LONG)); // `0` is parsed
746        check("x123", &[num(Year)], Err(INVALID));
747        check("o123", &[num(Year)], Err(INVALID));
748        check("2015", &[num(Year)], parsed!(year: 2015));
749        check("0000", &[num(Year)], parsed!(year: 0));
750        check("9999", &[num(Year)], parsed!(year: 9999));
751        check(" \t987", &[num(Year)], parsed!(year: 987));
752        check(" \t987", &[Space(" \t"), num(Year)], parsed!(year: 987));
753        check(" \t987🀠", &[Space(" \t"), num(Year), Literal("🀠")], parsed!(year: 987));
754        check("987🀠", &[num(Year), Literal("🀠")], parsed!(year: 987));
755        check("5", &[num(Year)], parsed!(year: 5));
756        check("5\0", &[num(Year)], Err(TOO_LONG));
757        check("\x005", &[num(Year)], Err(INVALID));
758        check("", &[num(Year)], Err(TOO_SHORT));
759        check("12345", &[num(Year), Literal("5")], parsed!(year: 1234));
760        check("12345", &[nums(Year), Literal("5")], parsed!(year: 1234));
761        check("12345", &[num0(Year), Literal("5")], parsed!(year: 1234));
762        check("12341234", &[num(Year), num(Year)], parsed!(year: 1234));
763        check("1234 1234", &[num(Year), num(Year)], parsed!(year: 1234));
764        check("1234 1234", &[num(Year), Space(" "), num(Year)], parsed!(year: 1234));
765        check("1234 1235", &[num(Year), num(Year)], Err(IMPOSSIBLE));
766        check("1234 1234", &[num(Year), Literal("x"), num(Year)], Err(INVALID));
767        check("1234x1234", &[num(Year), Literal("x"), num(Year)], parsed!(year: 1234));
768        check("1234 x 1234", &[num(Year), Literal("x"), num(Year)], Err(INVALID));
769        check("1234xx1234", &[num(Year), Literal("x"), num(Year)], Err(INVALID));
770        check("1234xx1234", &[num(Year), Literal("xx"), num(Year)], parsed!(year: 1234));
771        check(
772            "1234 x 1234",
773            &[num(Year), Space(" "), Literal("x"), Space(" "), num(Year)],
774            parsed!(year: 1234),
775        );
776        check(
777            "1234 x 1235",
778            &[num(Year), Space(" "), Literal("x"), Space(" "), Literal("1235")],
779            parsed!(year: 1234),
780        );
781
782        // signed numeric
783        check("-42", &[num(Year)], parsed!(year: -42));
784        check("+42", &[num(Year)], parsed!(year: 42));
785        check("-0042", &[num(Year)], parsed!(year: -42));
786        check("+0042", &[num(Year)], parsed!(year: 42));
787        check("-42195", &[num(Year)], parsed!(year: -42195));
788        check("βˆ’42195", &[num(Year)], Err(INVALID)); // MINUS SIGN (U+2212)
789        check("+42195", &[num(Year)], parsed!(year: 42195));
790        check("  -42195", &[num(Year)], parsed!(year: -42195));
791        check(" +42195", &[num(Year)], parsed!(year: 42195));
792        check("  -42195", &[num(Year)], parsed!(year: -42195));
793        check("  +42195", &[num(Year)], parsed!(year: 42195));
794        check("-42195 ", &[num(Year)], Err(TOO_LONG));
795        check("+42195 ", &[num(Year)], Err(TOO_LONG));
796        check("  -   42", &[num(Year)], Err(INVALID));
797        check("  +   42", &[num(Year)], Err(INVALID));
798        check("  -42195", &[Space("  "), num(Year)], parsed!(year: -42195));
799        check("  βˆ’42195", &[Space("  "), num(Year)], Err(INVALID)); // MINUS SIGN (U+2212)
800        check("  +42195", &[Space("  "), num(Year)], parsed!(year: 42195));
801        check("  -   42", &[Space("  "), num(Year)], Err(INVALID));
802        check("  +   42", &[Space("  "), num(Year)], Err(INVALID));
803        check("-", &[num(Year)], Err(TOO_SHORT));
804        check("+", &[num(Year)], Err(TOO_SHORT));
805
806        // unsigned numeric
807        check("345", &[num(Ordinal)], parsed!(ordinal: 345));
808        check("+345", &[num(Ordinal)], Err(INVALID));
809        check("-345", &[num(Ordinal)], Err(INVALID));
810        check(" 345", &[num(Ordinal)], parsed!(ordinal: 345));
811        check("βˆ’345", &[num(Ordinal)], Err(INVALID)); // MINUS SIGN (U+2212)
812        check("345 ", &[num(Ordinal)], Err(TOO_LONG));
813        check(" 345", &[Space(" "), num(Ordinal)], parsed!(ordinal: 345));
814        check("345 ", &[num(Ordinal), Space(" ")], parsed!(ordinal: 345));
815        check("345🀠 ", &[num(Ordinal), Literal("🀠"), Space(" ")], parsed!(ordinal: 345));
816        check("345🀠", &[num(Ordinal)], Err(TOO_LONG));
817        check("\u{0363}345", &[num(Ordinal)], Err(INVALID));
818        check(" +345", &[num(Ordinal)], Err(INVALID));
819        check(" -345", &[num(Ordinal)], Err(INVALID));
820        check("\t345", &[Space("\t"), num(Ordinal)], parsed!(ordinal: 345));
821        check(" +345", &[Space(" "), num(Ordinal)], Err(INVALID));
822        check(" -345", &[Space(" "), num(Ordinal)], Err(INVALID));
823
824        // various numeric fields
825        check("1234 5678", &[num(Year), num(IsoYear)], parsed!(year: 1234, isoyear: 5678));
826        check("1234 5678", &[num(Year), num(IsoYear)], parsed!(year: 1234, isoyear: 5678));
827        check(
828            "12 34 56 78",
829            &[num(YearDiv100), num(YearMod100), num(IsoYearDiv100), num(IsoYearMod100)],
830            parsed!(year_div_100: 12, year_mod_100: 34, isoyear_div_100: 56, isoyear_mod_100: 78),
831        );
832        check(
833            "1 2 3 4 5",
834            &[num(Month), num(Day), num(WeekFromSun), num(NumDaysFromSun), num(IsoWeek)],
835            parsed!(month: 1, day: 2, week_from_sun: 3, weekday: Weekday::Thu, isoweek: 5),
836        );
837        check(
838            "6 7 89 01",
839            &[num(WeekFromMon), num(WeekdayFromMon), num(Ordinal), num(Hour12)],
840            parsed!(week_from_mon: 6, weekday: Weekday::Sun, ordinal: 89, hour_mod_12: 1),
841        );
842        check(
843            "23 45 6 78901234 567890123",
844            &[num(Hour), num(Minute), num(Second), num(Nanosecond), num(Timestamp)],
845            parsed!(hour_div_12: 1, hour_mod_12: 11, minute: 45, second: 6, nanosecond: 78_901_234, timestamp: 567_890_123),
846        );
847    }
848
849    #[test]
850    fn test_parse_fixed() {
851        use crate::format::Fixed::*;
852        use crate::format::Item::{Literal, Space};
853
854        // fixed: month and weekday names
855        check("apr", &[fixed(ShortMonthName)], parsed!(month: 4));
856        check("Apr", &[fixed(ShortMonthName)], parsed!(month: 4));
857        check("APR", &[fixed(ShortMonthName)], parsed!(month: 4));
858        check("ApR", &[fixed(ShortMonthName)], parsed!(month: 4));
859        check("\u{0363}APR", &[fixed(ShortMonthName)], Err(INVALID));
860        check("April", &[fixed(ShortMonthName)], Err(TOO_LONG)); // `Apr` is parsed
861        check("A", &[fixed(ShortMonthName)], Err(TOO_SHORT));
862        check("Sol", &[fixed(ShortMonthName)], Err(INVALID));
863        check("Apr", &[fixed(LongMonthName)], parsed!(month: 4));
864        check("Apri", &[fixed(LongMonthName)], Err(TOO_LONG)); // `Apr` is parsed
865        check("April", &[fixed(LongMonthName)], parsed!(month: 4));
866        check("Aprill", &[fixed(LongMonthName)], Err(TOO_LONG));
867        check("Aprill", &[fixed(LongMonthName), Literal("l")], parsed!(month: 4));
868        check("Aprl", &[fixed(LongMonthName), Literal("l")], parsed!(month: 4));
869        check("April", &[fixed(LongMonthName), Literal("il")], Err(TOO_SHORT)); // do not backtrack
870        check("thu", &[fixed(ShortWeekdayName)], parsed!(weekday: Weekday::Thu));
871        check("Thu", &[fixed(ShortWeekdayName)], parsed!(weekday: Weekday::Thu));
872        check("THU", &[fixed(ShortWeekdayName)], parsed!(weekday: Weekday::Thu));
873        check("tHu", &[fixed(ShortWeekdayName)], parsed!(weekday: Weekday::Thu));
874        check("Thursday", &[fixed(ShortWeekdayName)], Err(TOO_LONG)); // `Thu` is parsed
875        check("T", &[fixed(ShortWeekdayName)], Err(TOO_SHORT));
876        check("The", &[fixed(ShortWeekdayName)], Err(INVALID));
877        check("Nop", &[fixed(ShortWeekdayName)], Err(INVALID));
878        check("Thu", &[fixed(LongWeekdayName)], parsed!(weekday: Weekday::Thu));
879        check("Thur", &[fixed(LongWeekdayName)], Err(TOO_LONG)); // `Thu` is parsed
880        check("Thurs", &[fixed(LongWeekdayName)], Err(TOO_LONG)); // `Thu` is parsed
881        check("Thursday", &[fixed(LongWeekdayName)], parsed!(weekday: Weekday::Thu));
882        check("Thursdays", &[fixed(LongWeekdayName)], Err(TOO_LONG));
883        check("Thursdays", &[fixed(LongWeekdayName), Literal("s")], parsed!(weekday: Weekday::Thu));
884        check("Thus", &[fixed(LongWeekdayName), Literal("s")], parsed!(weekday: Weekday::Thu));
885        check("Thursday", &[fixed(LongWeekdayName), Literal("rsday")], Err(TOO_SHORT)); // do not backtrack
886
887        // fixed: am/pm
888        check("am", &[fixed(LowerAmPm)], parsed!(hour_div_12: 0));
889        check("pm", &[fixed(LowerAmPm)], parsed!(hour_div_12: 1));
890        check("AM", &[fixed(LowerAmPm)], parsed!(hour_div_12: 0));
891        check("PM", &[fixed(LowerAmPm)], parsed!(hour_div_12: 1));
892        check("am", &[fixed(UpperAmPm)], parsed!(hour_div_12: 0));
893        check("pm", &[fixed(UpperAmPm)], parsed!(hour_div_12: 1));
894        check("AM", &[fixed(UpperAmPm)], parsed!(hour_div_12: 0));
895        check("PM", &[fixed(UpperAmPm)], parsed!(hour_div_12: 1));
896        check("Am", &[fixed(LowerAmPm)], parsed!(hour_div_12: 0));
897        check(" Am", &[Space(" "), fixed(LowerAmPm)], parsed!(hour_div_12: 0));
898        check("Am🀠", &[fixed(LowerAmPm), Literal("🀠")], parsed!(hour_div_12: 0));
899        check("🀠Am", &[Literal("🀠"), fixed(LowerAmPm)], parsed!(hour_div_12: 0));
900        check("\u{0363}am", &[fixed(LowerAmPm)], Err(INVALID));
901        check("\u{0360}am", &[fixed(LowerAmPm)], Err(INVALID));
902        check(" Am", &[fixed(LowerAmPm)], Err(INVALID));
903        check("Am ", &[fixed(LowerAmPm)], Err(TOO_LONG));
904        check("a.m.", &[fixed(LowerAmPm)], Err(INVALID));
905        check("A.M.", &[fixed(LowerAmPm)], Err(INVALID));
906        check("ame", &[fixed(LowerAmPm)], Err(TOO_LONG)); // `am` is parsed
907        check("a", &[fixed(LowerAmPm)], Err(TOO_SHORT));
908        check("p", &[fixed(LowerAmPm)], Err(TOO_SHORT));
909        check("x", &[fixed(LowerAmPm)], Err(TOO_SHORT));
910        check("xx", &[fixed(LowerAmPm)], Err(INVALID));
911        check("", &[fixed(LowerAmPm)], Err(TOO_SHORT));
912    }
913
914    #[test]
915    fn test_parse_fixed_nanosecond() {
916        use crate::format::Fixed::Nanosecond;
917        use crate::format::InternalInternal::*;
918        use crate::format::Item::Literal;
919        use crate::format::Numeric::Second;
920
921        // fixed: dot plus nanoseconds
922        check("", &[fixed(Nanosecond)], parsed!()); // no field set, but not an error
923        check(".", &[fixed(Nanosecond)], Err(TOO_SHORT));
924        check("4", &[fixed(Nanosecond)], Err(TOO_LONG)); // never consumes `4`
925        check("4", &[fixed(Nanosecond), num(Second)], parsed!(second: 4));
926        check(".0", &[fixed(Nanosecond)], parsed!(nanosecond: 0));
927        check(".4", &[fixed(Nanosecond)], parsed!(nanosecond: 400_000_000));
928        check(".42", &[fixed(Nanosecond)], parsed!(nanosecond: 420_000_000));
929        check(".421", &[fixed(Nanosecond)], parsed!(nanosecond: 421_000_000));
930        check(".42195", &[fixed(Nanosecond)], parsed!(nanosecond: 421_950_000));
931        check(".421951", &[fixed(Nanosecond)], parsed!(nanosecond: 421_951_000));
932        check(".4219512", &[fixed(Nanosecond)], parsed!(nanosecond: 421_951_200));
933        check(".42195123", &[fixed(Nanosecond)], parsed!(nanosecond: 421_951_230));
934        check(".421950803", &[fixed(Nanosecond)], parsed!(nanosecond: 421_950_803));
935        check(".4219508035", &[fixed(Nanosecond)], parsed!(nanosecond: 421_950_803));
936        check(".42195080354", &[fixed(Nanosecond)], parsed!(nanosecond: 421_950_803));
937        check(".421950803547", &[fixed(Nanosecond)], parsed!(nanosecond: 421_950_803));
938        check(".000000003", &[fixed(Nanosecond)], parsed!(nanosecond: 3));
939        check(".0000000031", &[fixed(Nanosecond)], parsed!(nanosecond: 3));
940        check(".0000000035", &[fixed(Nanosecond)], parsed!(nanosecond: 3));
941        check(".000000003547", &[fixed(Nanosecond)], parsed!(nanosecond: 3));
942        check(".0000000009", &[fixed(Nanosecond)], parsed!(nanosecond: 0));
943        check(".000000000547", &[fixed(Nanosecond)], parsed!(nanosecond: 0));
944        check(".0000000009999999999999999999999999", &[fixed(Nanosecond)], parsed!(nanosecond: 0));
945        check(".4🀠", &[fixed(Nanosecond), Literal("🀠")], parsed!(nanosecond: 400_000_000));
946        check(".4x", &[fixed(Nanosecond)], Err(TOO_LONG));
947        check(".  4", &[fixed(Nanosecond)], Err(INVALID));
948        check("  .4", &[fixed(Nanosecond)], Err(TOO_LONG)); // no automatic trimming
949
950        // fixed: nanoseconds without the dot
951        check("", &[internal_fixed(Nanosecond3NoDot)], Err(TOO_SHORT));
952        check(".", &[internal_fixed(Nanosecond3NoDot)], Err(TOO_SHORT));
953        check("0", &[internal_fixed(Nanosecond3NoDot)], Err(TOO_SHORT));
954        check("4", &[internal_fixed(Nanosecond3NoDot)], Err(TOO_SHORT));
955        check("42", &[internal_fixed(Nanosecond3NoDot)], Err(TOO_SHORT));
956        check("421", &[internal_fixed(Nanosecond3NoDot)], parsed!(nanosecond: 421_000_000));
957        check("4210", &[internal_fixed(Nanosecond3NoDot)], Err(TOO_LONG));
958        check(
959            "42143",
960            &[internal_fixed(Nanosecond3NoDot), num(Second)],
961            parsed!(nanosecond: 421_000_000, second: 43),
962        );
963        check(
964            "421🀠",
965            &[internal_fixed(Nanosecond3NoDot), Literal("🀠")],
966            parsed!(nanosecond: 421_000_000),
967        );
968        check(
969            "🀠421",
970            &[Literal("🀠"), internal_fixed(Nanosecond3NoDot)],
971            parsed!(nanosecond: 421_000_000),
972        );
973        check("42195", &[internal_fixed(Nanosecond3NoDot)], Err(TOO_LONG));
974        check("123456789", &[internal_fixed(Nanosecond3NoDot)], Err(TOO_LONG));
975        check("4x", &[internal_fixed(Nanosecond3NoDot)], Err(TOO_SHORT));
976        check("  4", &[internal_fixed(Nanosecond3NoDot)], Err(INVALID));
977        check(".421", &[internal_fixed(Nanosecond3NoDot)], Err(INVALID));
978
979        check("", &[internal_fixed(Nanosecond6NoDot)], Err(TOO_SHORT));
980        check(".", &[internal_fixed(Nanosecond6NoDot)], Err(TOO_SHORT));
981        check("0", &[internal_fixed(Nanosecond6NoDot)], Err(TOO_SHORT));
982        check("1234", &[internal_fixed(Nanosecond6NoDot)], Err(TOO_SHORT));
983        check("12345", &[internal_fixed(Nanosecond6NoDot)], Err(TOO_SHORT));
984        check("421950", &[internal_fixed(Nanosecond6NoDot)], parsed!(nanosecond: 421_950_000));
985        check("000003", &[internal_fixed(Nanosecond6NoDot)], parsed!(nanosecond: 3000));
986        check("000000", &[internal_fixed(Nanosecond6NoDot)], parsed!(nanosecond: 0));
987        check("1234567", &[internal_fixed(Nanosecond6NoDot)], Err(TOO_LONG));
988        check("123456789", &[internal_fixed(Nanosecond6NoDot)], Err(TOO_LONG));
989        check("4x", &[internal_fixed(Nanosecond6NoDot)], Err(TOO_SHORT));
990        check("     4", &[internal_fixed(Nanosecond6NoDot)], Err(INVALID));
991        check(".42100", &[internal_fixed(Nanosecond6NoDot)], Err(INVALID));
992
993        check("", &[internal_fixed(Nanosecond9NoDot)], Err(TOO_SHORT));
994        check(".", &[internal_fixed(Nanosecond9NoDot)], Err(TOO_SHORT));
995        check("42195", &[internal_fixed(Nanosecond9NoDot)], Err(TOO_SHORT));
996        check("12345678", &[internal_fixed(Nanosecond9NoDot)], Err(TOO_SHORT));
997        check("421950803", &[internal_fixed(Nanosecond9NoDot)], parsed!(nanosecond: 421_950_803));
998        check("000000003", &[internal_fixed(Nanosecond9NoDot)], parsed!(nanosecond: 3));
999        check(
1000            "42195080354",
1001            &[internal_fixed(Nanosecond9NoDot), num(Second)],
1002            parsed!(nanosecond: 421_950_803, second: 54),
1003        ); // don't skip digits that come after the 9
1004        check("1234567890", &[internal_fixed(Nanosecond9NoDot)], Err(TOO_LONG));
1005        check("000000000", &[internal_fixed(Nanosecond9NoDot)], parsed!(nanosecond: 0));
1006        check("00000000x", &[internal_fixed(Nanosecond9NoDot)], Err(INVALID));
1007        check("        4", &[internal_fixed(Nanosecond9NoDot)], Err(INVALID));
1008        check(".42100000", &[internal_fixed(Nanosecond9NoDot)], Err(INVALID));
1009    }
1010
1011    #[test]
1012    fn test_parse_fixed_timezone_offset() {
1013        use crate::format::Fixed::*;
1014        use crate::format::InternalInternal::*;
1015        use crate::format::Item::Literal;
1016
1017        // TimezoneOffset
1018        check("1", &[fixed(TimezoneOffset)], Err(INVALID));
1019        check("12", &[fixed(TimezoneOffset)], Err(INVALID));
1020        check("123", &[fixed(TimezoneOffset)], Err(INVALID));
1021        check("1234", &[fixed(TimezoneOffset)], Err(INVALID));
1022        check("12345", &[fixed(TimezoneOffset)], Err(INVALID));
1023        check("123456", &[fixed(TimezoneOffset)], Err(INVALID));
1024        check("1234567", &[fixed(TimezoneOffset)], Err(INVALID));
1025        check("+1", &[fixed(TimezoneOffset)], Err(TOO_SHORT));
1026        check("+12", &[fixed(TimezoneOffset)], Err(TOO_SHORT));
1027        check("+123", &[fixed(TimezoneOffset)], Err(TOO_SHORT));
1028        check("+1234", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1029        check("+12345", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1030        check("+123456", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1031        check("+1234567", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1032        check("+12345678", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1033        check("+12:", &[fixed(TimezoneOffset)], Err(TOO_SHORT));
1034        check("+12:3", &[fixed(TimezoneOffset)], Err(TOO_SHORT));
1035        check("+12:34", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1036        check("-12:34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1037        check("βˆ’12:34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1038        check("+12:34:", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1039        check("+12:34:5", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1040        check("+12:34:56", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1041        check("+12:34:56:", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1042        check("+12 34", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1043        check("+12  34", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1044        check("12:34", &[fixed(TimezoneOffset)], Err(INVALID));
1045        check("12:34:56", &[fixed(TimezoneOffset)], Err(INVALID));
1046        check("+12::34", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1047        check("+12: :34", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1048        check("+12:::34", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1049        check("+12::::34", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1050        check("+12::34", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1051        check("+12:34:56", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1052        check("+12:3456", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1053        check("+1234:56", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1054        check("+1234:567", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1055        check("+00:00", &[fixed(TimezoneOffset)], parsed!(offset: 0));
1056        check("-00:00", &[fixed(TimezoneOffset)], parsed!(offset: 0));
1057        check("βˆ’00:00", &[fixed(TimezoneOffset)], parsed!(offset: 0)); // MINUS SIGN (U+2212)
1058        check("+00:01", &[fixed(TimezoneOffset)], parsed!(offset: 60));
1059        check("-00:01", &[fixed(TimezoneOffset)], parsed!(offset: -60));
1060        check("+00:30", &[fixed(TimezoneOffset)], parsed!(offset: 1_800));
1061        check("-00:30", &[fixed(TimezoneOffset)], parsed!(offset: -1_800));
1062        check("+24:00", &[fixed(TimezoneOffset)], parsed!(offset: 86_400));
1063        check("-24:00", &[fixed(TimezoneOffset)], parsed!(offset: -86_400));
1064        check("βˆ’24:00", &[fixed(TimezoneOffset)], parsed!(offset: -86_400)); // MINUS SIGN (U+2212)
1065        check("+99:59", &[fixed(TimezoneOffset)], parsed!(offset: 359_940));
1066        check("-99:59", &[fixed(TimezoneOffset)], parsed!(offset: -359_940));
1067        check("+00:60", &[fixed(TimezoneOffset)], Err(OUT_OF_RANGE));
1068        check("+00:99", &[fixed(TimezoneOffset)], Err(OUT_OF_RANGE));
1069        check("#12:34", &[fixed(TimezoneOffset)], Err(INVALID));
1070        check("+12:34 ", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1071        check("+12 34 ", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1072        check(" +12:34", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1073        check(" -12:34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1074        check(" βˆ’12:34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1075        check("  +12:34", &[fixed(TimezoneOffset)], parsed!(offset: 45_240));
1076        check("  -12:34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1077        check("\t -12:34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1078        check("-12: 34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1079        check("-12 :34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1080        check("-12 : 34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1081        check("-12 :  34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1082        check("-12  : 34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1083        check("-12:  34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1084        check("-12  :34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1085        check("-12  :  34", &[fixed(TimezoneOffset)], parsed!(offset: -45_240));
1086        check("12:34 ", &[fixed(TimezoneOffset)], Err(INVALID));
1087        check(" 12:34", &[fixed(TimezoneOffset)], Err(INVALID));
1088        check("", &[fixed(TimezoneOffset)], Err(TOO_SHORT));
1089        check("+", &[fixed(TimezoneOffset)], Err(TOO_SHORT));
1090        check(
1091            "+12345",
1092            &[fixed(TimezoneOffset), num(Numeric::Day)],
1093            parsed!(offset: 45_240, day: 5),
1094        );
1095        check(
1096            "+12:345",
1097            &[fixed(TimezoneOffset), num(Numeric::Day)],
1098            parsed!(offset: 45_240, day: 5),
1099        );
1100        check("+12:34:", &[fixed(TimezoneOffset), Literal(":")], parsed!(offset: 45_240));
1101        check("Z12:34", &[fixed(TimezoneOffset)], Err(INVALID));
1102        check("X12:34", &[fixed(TimezoneOffset)], Err(INVALID));
1103        check("Z+12:34", &[fixed(TimezoneOffset)], Err(INVALID));
1104        check("X+12:34", &[fixed(TimezoneOffset)], Err(INVALID));
1105        check("Xβˆ’12:34", &[fixed(TimezoneOffset)], Err(INVALID)); // MINUS SIGN (U+2212)
1106        check("🀠+12:34", &[fixed(TimezoneOffset)], Err(INVALID));
1107        check("+12:34🀠", &[fixed(TimezoneOffset)], Err(TOO_LONG));
1108        check("+12:🀠34", &[fixed(TimezoneOffset)], Err(INVALID));
1109        check("+1234🀠", &[fixed(TimezoneOffset), Literal("🀠")], parsed!(offset: 45_240));
1110        check("-1234🀠", &[fixed(TimezoneOffset), Literal("🀠")], parsed!(offset: -45_240));
1111        check("βˆ’1234🀠", &[fixed(TimezoneOffset), Literal("🀠")], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1112        check("+12:34🀠", &[fixed(TimezoneOffset), Literal("🀠")], parsed!(offset: 45_240));
1113        check("-12:34🀠", &[fixed(TimezoneOffset), Literal("🀠")], parsed!(offset: -45_240));
1114        check("βˆ’12:34🀠", &[fixed(TimezoneOffset), Literal("🀠")], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1115        check("🀠+12:34", &[Literal("🀠"), fixed(TimezoneOffset)], parsed!(offset: 45_240));
1116        check("Z", &[fixed(TimezoneOffset)], Err(INVALID));
1117        check("A", &[fixed(TimezoneOffset)], Err(INVALID));
1118        check("PST", &[fixed(TimezoneOffset)], Err(INVALID));
1119        check("#Z", &[fixed(TimezoneOffset)], Err(INVALID));
1120        check(":Z", &[fixed(TimezoneOffset)], Err(INVALID));
1121        check("+Z", &[fixed(TimezoneOffset)], Err(TOO_SHORT));
1122        check("+:Z", &[fixed(TimezoneOffset)], Err(INVALID));
1123        check("+Z:", &[fixed(TimezoneOffset)], Err(INVALID));
1124        check("z", &[fixed(TimezoneOffset)], Err(INVALID));
1125        check(" :Z", &[fixed(TimezoneOffset)], Err(INVALID));
1126        check(" Z", &[fixed(TimezoneOffset)], Err(INVALID));
1127        check(" z", &[fixed(TimezoneOffset)], Err(INVALID));
1128
1129        // TimezoneOffsetColon
1130        check("1", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1131        check("12", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1132        check("123", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1133        check("1234", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1134        check("12345", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1135        check("123456", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1136        check("1234567", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1137        check("12345678", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1138        check("+1", &[fixed(TimezoneOffsetColon)], Err(TOO_SHORT));
1139        check("+12", &[fixed(TimezoneOffsetColon)], Err(TOO_SHORT));
1140        check("+123", &[fixed(TimezoneOffsetColon)], Err(TOO_SHORT));
1141        check("+1234", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1142        check("-1234", &[fixed(TimezoneOffsetColon)], parsed!(offset: -45_240));
1143        check("βˆ’1234", &[fixed(TimezoneOffsetColon)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1144        check("+12345", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1145        check("+123456", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1146        check("+1234567", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1147        check("+12345678", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1148        check("1:", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1149        check("12:", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1150        check("12:3", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1151        check("12:34", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1152        check("12:34:", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1153        check("12:34:5", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1154        check("12:34:56", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1155        check("+1:", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1156        check("+12:", &[fixed(TimezoneOffsetColon)], Err(TOO_SHORT));
1157        check("+12:3", &[fixed(TimezoneOffsetColon)], Err(TOO_SHORT));
1158        check("+12:34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1159        check("-12:34", &[fixed(TimezoneOffsetColon)], parsed!(offset: -45_240));
1160        check("βˆ’12:34", &[fixed(TimezoneOffsetColon)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1161        check("+12:34:", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1162        check("+12:34:5", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1163        check("+12:34:56", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1164        check("+12:34:56:", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1165        check("+12:34:56:7", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1166        check("+12:34:56:78", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1167        check("+12:3456", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1168        check("+1234:56", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1169        check("βˆ’12:34", &[fixed(TimezoneOffsetColon)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1170        check("βˆ’12 : 34", &[fixed(TimezoneOffsetColon)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1171        check("+12 :34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1172        check("+12: 34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1173        check("+12 34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1174        check("+12: 34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1175        check("+12 :34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1176        check("+12 : 34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1177        check("-12 : 34", &[fixed(TimezoneOffsetColon)], parsed!(offset: -45_240));
1178        check("+12  : 34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1179        check("+12 :  34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1180        check("+12  :  34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1181        check("+12::34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1182        check("+12: :34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1183        check("+12:::34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1184        check("+12::::34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1185        check("+12::34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1186        check("#1234", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1187        check("#12:34", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1188        check("+12:34 ", &[fixed(TimezoneOffsetColon)], Err(TOO_LONG));
1189        check(" +12:34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1190        check("\t+12:34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1191        check("\t\t+12:34", &[fixed(TimezoneOffsetColon)], parsed!(offset: 45_240));
1192        check("12:34 ", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1193        check(" 12:34", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1194        check("", &[fixed(TimezoneOffsetColon)], Err(TOO_SHORT));
1195        check("+", &[fixed(TimezoneOffsetColon)], Err(TOO_SHORT));
1196        check(":", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1197        check(
1198            "+12345",
1199            &[fixed(TimezoneOffsetColon), num(Numeric::Day)],
1200            parsed!(offset: 45_240, day: 5),
1201        );
1202        check(
1203            "+12:345",
1204            &[fixed(TimezoneOffsetColon), num(Numeric::Day)],
1205            parsed!(offset: 45_240, day: 5),
1206        );
1207        check("+12:34:", &[fixed(TimezoneOffsetColon), Literal(":")], parsed!(offset: 45_240));
1208        check("Z", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1209        check("A", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1210        check("PST", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1211        check("#Z", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1212        check(":Z", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1213        check("+Z", &[fixed(TimezoneOffsetColon)], Err(TOO_SHORT));
1214        check("+:Z", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1215        check("+Z:", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1216        check("z", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1217        check(" :Z", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1218        check(" Z", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1219        check(" z", &[fixed(TimezoneOffsetColon)], Err(INVALID));
1220        // testing `TimezoneOffsetColon` also tests same path as `TimezoneOffsetDoubleColon`
1221        // and `TimezoneOffsetTripleColon` for function `parse_internal`.
1222        // No need for separate tests for `TimezoneOffsetDoubleColon` and
1223        // `TimezoneOffsetTripleColon`.
1224
1225        // TimezoneOffsetZ
1226        check("1", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1227        check("12", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1228        check("123", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1229        check("1234", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1230        check("12345", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1231        check("123456", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1232        check("1234567", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1233        check("12345678", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1234        check("+1", &[fixed(TimezoneOffsetZ)], Err(TOO_SHORT));
1235        check("+12", &[fixed(TimezoneOffsetZ)], Err(TOO_SHORT));
1236        check("+123", &[fixed(TimezoneOffsetZ)], Err(TOO_SHORT));
1237        check("+1234", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1238        check("-1234", &[fixed(TimezoneOffsetZ)], parsed!(offset: -45_240));
1239        check("βˆ’1234", &[fixed(TimezoneOffsetZ)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1240        check("+12345", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1241        check("+123456", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1242        check("+1234567", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1243        check("+12345678", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1244        check("1:", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1245        check("12:", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1246        check("12:3", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1247        check("12:34", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1248        check("12:34:", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1249        check("12:34:5", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1250        check("12:34:56", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1251        check("+1:", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1252        check("+12:", &[fixed(TimezoneOffsetZ)], Err(TOO_SHORT));
1253        check("+12:3", &[fixed(TimezoneOffsetZ)], Err(TOO_SHORT));
1254        check("+12:34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1255        check("-12:34", &[fixed(TimezoneOffsetZ)], parsed!(offset: -45_240));
1256        check("βˆ’12:34", &[fixed(TimezoneOffsetZ)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1257        check("+12:34:", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1258        check("+12:34:5", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1259        check("+12:34:56", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1260        check("+12:34:56:", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1261        check("+12:34:56:7", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1262        check("+12:34:56:78", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1263        check("+12::34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1264        check("+12:3456", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1265        check("+1234:56", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1266        check("+12 34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1267        check("+12  34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1268        check("+12: 34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1269        check("+12 :34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1270        check("+12 : 34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1271        check("+12  : 34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1272        check("+12 :  34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1273        check("+12  :  34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1274        check("12:34 ", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1275        check(" 12:34", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1276        check("+12:34 ", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1277        check("+12 34 ", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1278        check(" +12:34", &[fixed(TimezoneOffsetZ)], parsed!(offset: 45_240));
1279        check(
1280            "+12345",
1281            &[fixed(TimezoneOffsetZ), num(Numeric::Day)],
1282            parsed!(offset: 45_240, day: 5),
1283        );
1284        check(
1285            "+12:345",
1286            &[fixed(TimezoneOffsetZ), num(Numeric::Day)],
1287            parsed!(offset: 45_240, day: 5),
1288        );
1289        check("+12:34:", &[fixed(TimezoneOffsetZ), Literal(":")], parsed!(offset: 45_240));
1290        check("Z12:34", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1291        check("X12:34", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1292        check("Z", &[fixed(TimezoneOffsetZ)], parsed!(offset: 0));
1293        check("z", &[fixed(TimezoneOffsetZ)], parsed!(offset: 0));
1294        check(" Z", &[fixed(TimezoneOffsetZ)], parsed!(offset: 0));
1295        check(" z", &[fixed(TimezoneOffsetZ)], parsed!(offset: 0));
1296        check("\u{0363}Z", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1297        check("Z ", &[fixed(TimezoneOffsetZ)], Err(TOO_LONG));
1298        check("A", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1299        check("PST", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1300        check("#Z", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1301        check(":Z", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1302        check(":z", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1303        check("+Z", &[fixed(TimezoneOffsetZ)], Err(TOO_SHORT));
1304        check("-Z", &[fixed(TimezoneOffsetZ)], Err(TOO_SHORT));
1305        check("+A", &[fixed(TimezoneOffsetZ)], Err(TOO_SHORT));
1306        check("+πŸ™ƒ", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1307        check("+Z:", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1308        check(" :Z", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1309        check(" +Z", &[fixed(TimezoneOffsetZ)], Err(TOO_SHORT));
1310        check(" -Z", &[fixed(TimezoneOffsetZ)], Err(TOO_SHORT));
1311        check("+:Z", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1312        check("Y", &[fixed(TimezoneOffsetZ)], Err(INVALID));
1313        check("Zulu", &[fixed(TimezoneOffsetZ), Literal("ulu")], parsed!(offset: 0));
1314        check("zulu", &[fixed(TimezoneOffsetZ), Literal("ulu")], parsed!(offset: 0));
1315        check("+1234ulu", &[fixed(TimezoneOffsetZ), Literal("ulu")], parsed!(offset: 45_240));
1316        check("+12:34ulu", &[fixed(TimezoneOffsetZ), Literal("ulu")], parsed!(offset: 45_240));
1317        // Testing `TimezoneOffsetZ` also tests same path as `TimezoneOffsetColonZ`
1318        // in function `parse_internal`.
1319        // No need for separate tests for `TimezoneOffsetColonZ`.
1320
1321        // TimezoneOffsetPermissive
1322        check("1", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1323        check("12", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1324        check("123", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1325        check("1234", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1326        check("12345", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1327        check("123456", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1328        check("1234567", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1329        check("12345678", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1330        check("+1", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_SHORT));
1331        check("+12", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 43_200));
1332        check("+123", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_SHORT));
1333        check("+1234", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1334        check("-1234", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: -45_240));
1335        check("βˆ’1234", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1336        check("+12345", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1337        check("+123456", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1338        check("+1234567", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1339        check("+12345678", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1340        check("1:", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1341        check("12:", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1342        check("12:3", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1343        check("12:34", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1344        check("12:34:", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1345        check("12:34:5", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1346        check("12:34:56", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1347        check("+1:", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1348        check("+12:", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 43_200));
1349        check("+12:3", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_SHORT));
1350        check("+12:34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1351        check("-12:34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: -45_240));
1352        check("βˆ’12:34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1353        check("+12:34:", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1354        check("+12:34:5", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1355        check("+12:34:56", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1356        check("+12:34:56:", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1357        check("+12:34:56:7", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1358        check("+12:34:56:78", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1359        check("+12 34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1360        check("+12  34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1361        check("+12 :34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1362        check("+12: 34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1363        check("+12 : 34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1364        check("+12  :34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1365        check("+12:  34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1366        check("+12  :  34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1367        check("+12::34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1368        check("+12 ::34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1369        check("+12: :34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1370        check("+12:: 34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1371        check("+12  ::34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1372        check("+12:  :34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1373        check("+12::  34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1374        check("+12:::34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1375        check("+12::::34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1376        check("12:34 ", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1377        check(" 12:34", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1378        check("+12:34 ", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1379        check(" +12:34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 45_240));
1380        check(" -12:34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: -45_240));
1381        check(" βˆ’12:34", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: -45_240)); // MINUS SIGN (U+2212)
1382        check(
1383            "+12345",
1384            &[internal_fixed(TimezoneOffsetPermissive), num(Numeric::Day)],
1385            parsed!(offset: 45_240, day: 5),
1386        );
1387        check(
1388            "+12:345",
1389            &[internal_fixed(TimezoneOffsetPermissive), num(Numeric::Day)],
1390            parsed!(offset: 45_240, day: 5),
1391        );
1392        check(
1393            "+12:34:",
1394            &[internal_fixed(TimezoneOffsetPermissive), Literal(":")],
1395            parsed!(offset: 45_240),
1396        );
1397        check("🀠+12:34", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1398        check("+12:34🀠", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1399        check("+12:🀠34", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1400        check(
1401            "+12:34🀠",
1402            &[internal_fixed(TimezoneOffsetPermissive), Literal("🀠")],
1403            parsed!(offset: 45_240),
1404        );
1405        check(
1406            "🀠+12:34",
1407            &[Literal("🀠"), internal_fixed(TimezoneOffsetPermissive)],
1408            parsed!(offset: 45_240),
1409        );
1410        check("Z", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 0));
1411        check("A", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1412        check("PST", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1413        check("z", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 0));
1414        check(" Z", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 0));
1415        check(" z", &[internal_fixed(TimezoneOffsetPermissive)], parsed!(offset: 0));
1416        check("Z ", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_LONG));
1417        check("#Z", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1418        check(":Z", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1419        check(":z", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1420        check("+Z", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_SHORT));
1421        check("-Z", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_SHORT));
1422        check("+A", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_SHORT));
1423        check("+PST", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1424        check("+πŸ™ƒ", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1425        check("+Z:", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1426        check(" :Z", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1427        check(" +Z", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_SHORT));
1428        check(" -Z", &[internal_fixed(TimezoneOffsetPermissive)], Err(TOO_SHORT));
1429        check("+:Z", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1430        check("Y", &[internal_fixed(TimezoneOffsetPermissive)], Err(INVALID));
1431
1432        // TimezoneName
1433        check("CEST", &[fixed(TimezoneName)], parsed!());
1434        check("cest", &[fixed(TimezoneName)], parsed!()); // lowercase
1435        check("XXXXXXXX", &[fixed(TimezoneName)], parsed!()); // not a real timezone name
1436        check("!!!!", &[fixed(TimezoneName)], parsed!()); // not a real timezone name!
1437        check("CEST 5", &[fixed(TimezoneName), Literal(" "), num(Numeric::Day)], parsed!(day: 5));
1438        check("CEST ", &[fixed(TimezoneName)], Err(TOO_LONG));
1439        check(" CEST", &[fixed(TimezoneName)], Err(TOO_LONG));
1440        check("CE ST", &[fixed(TimezoneName)], Err(TOO_LONG));
1441    }
1442
1443    #[test]
1444    #[rustfmt::skip]
1445    fn test_parse_practical_examples() {
1446        use crate::format::InternalInternal::*;
1447        use crate::format::Item::{Literal, Space};
1448        use crate::format::Numeric::*;
1449
1450        // some practical examples
1451        check(
1452            "2015-02-04T14:37:05+09:00",
1453            &[
1454                num(Year), Literal("-"), num(Month), Literal("-"), num(Day), Literal("T"),
1455                num(Hour), Literal(":"), num(Minute), Literal(":"), num(Second),
1456                fixed(Fixed::TimezoneOffset),
1457            ],
1458            parsed!(
1459                year: 2015, month: 2, day: 4, hour_div_12: 1, hour_mod_12: 2, minute: 37,
1460                second: 5, offset: 32400
1461            ),
1462        );
1463        check(
1464            "2015-02-04T14:37:05-09:00",
1465            &[
1466                num(Year), Literal("-"), num(Month), Literal("-"), num(Day), Literal("T"),
1467                num(Hour), Literal(":"), num(Minute), Literal(":"), num(Second),
1468                fixed(Fixed::TimezoneOffset),
1469            ],
1470            parsed!(
1471                year: 2015, month: 2, day: 4, hour_div_12: 1, hour_mod_12: 2, minute: 37,
1472                second: 5, offset: -32400
1473            ),
1474        );
1475        check(
1476            "2015-02-04T14:37:05βˆ’09:00", // timezone offset using MINUS SIGN (U+2212)
1477            &[
1478                num(Year), Literal("-"), num(Month), Literal("-"), num(Day), Literal("T"),
1479                num(Hour), Literal(":"), num(Minute), Literal(":"), num(Second),
1480                fixed(Fixed::TimezoneOffset)
1481            ],
1482            parsed!(
1483                year: 2015, month: 2, day: 4, hour_div_12: 1, hour_mod_12: 2, minute: 37,
1484                second: 5, offset: -32400
1485            ),
1486        );
1487        check(
1488            "20150204143705567",
1489            &[
1490                num(Year), num(Month), num(Day), num(Hour), num(Minute), num(Second),
1491                internal_fixed(Nanosecond3NoDot)
1492            ],
1493            parsed!(
1494                year: 2015, month: 2, day: 4, hour_div_12: 1, hour_mod_12: 2, minute: 37,
1495                second: 5, nanosecond: 567000000
1496            ),
1497        );
1498        check(
1499            "Mon, 10 Jun 2013 09:32:37 GMT",
1500            &[
1501                fixed(Fixed::ShortWeekdayName), Literal(","), Space(" "), num(Day), Space(" "),
1502                fixed(Fixed::ShortMonthName), Space(" "), num(Year), Space(" "), num(Hour),
1503                Literal(":"), num(Minute), Literal(":"), num(Second), Space(" "), Literal("GMT")
1504            ],
1505            parsed!(
1506                year: 2013, month: 6, day: 10, weekday: Weekday::Mon,
1507                hour_div_12: 0, hour_mod_12: 9, minute: 32, second: 37
1508            ),
1509        );
1510        check(
1511            "🀠Mon, 10 Jun🀠2013 09:32:37  GMT🀠",
1512            &[
1513                Literal("🀠"), fixed(Fixed::ShortWeekdayName), Literal(","), Space(" "), num(Day),
1514                Space(" "), fixed(Fixed::ShortMonthName), Literal("🀠"), num(Year), Space(" "),
1515                num(Hour), Literal(":"), num(Minute), Literal(":"), num(Second), Space("  "),
1516                Literal("GMT"), Literal("🀠")
1517            ],
1518            parsed!(
1519                year: 2013, month: 6, day: 10, weekday: Weekday::Mon,
1520                hour_div_12: 0, hour_mod_12: 9, minute: 32, second: 37
1521            ),
1522        );
1523        check(
1524            "Sun Aug 02 13:39:15 CEST 2020",
1525            &[
1526                fixed(Fixed::ShortWeekdayName), Space(" "), fixed(Fixed::ShortMonthName),
1527                Space(" "), num(Day), Space(" "), num(Hour), Literal(":"), num(Minute),
1528                Literal(":"), num(Second), Space(" "), fixed(Fixed::TimezoneName), Space(" "),
1529                num(Year)
1530            ],
1531            parsed!(
1532                year: 2020, month: 8, day: 2, weekday: Weekday::Sun,
1533                hour_div_12: 1, hour_mod_12: 1, minute: 39, second: 15
1534            ),
1535        );
1536        check(
1537            "20060102150405",
1538            &[num(Year), num(Month), num(Day), num(Hour), num(Minute), num(Second)],
1539            parsed!(
1540                year: 2006, month: 1, day: 2, hour_div_12: 1, hour_mod_12: 3, minute: 4, second: 5
1541            ),
1542        );
1543        check(
1544            "3:14PM",
1545            &[num(Hour12), Literal(":"), num(Minute), fixed(Fixed::LowerAmPm)],
1546            parsed!(hour_div_12: 1, hour_mod_12: 3, minute: 14),
1547        );
1548        check(
1549            "12345678901234.56789",
1550            &[num(Timestamp), Literal("."), num(Nanosecond)],
1551            parsed!(nanosecond: 56_789, timestamp: 12_345_678_901_234),
1552        );
1553        check(
1554            "12345678901234.56789",
1555            &[num(Timestamp), fixed(Fixed::Nanosecond)],
1556            parsed!(nanosecond: 567_890_000, timestamp: 12_345_678_901_234),
1557        );
1558
1559        // docstring examples from `impl str::FromStr`
1560        check(
1561            "2000-01-02T03:04:05Z",
1562            &[
1563                num(Year), Literal("-"), num(Month), Literal("-"), num(Day), Literal("T"),
1564                num(Hour), Literal(":"), num(Minute), Literal(":"), num(Second),
1565                internal_fixed(TimezoneOffsetPermissive)
1566            ],
1567            parsed!(
1568                year: 2000, month: 1, day: 2, hour_div_12: 0, hour_mod_12: 3, minute: 4, second: 5,
1569                offset: 0
1570            ),
1571        );
1572        check(
1573            "2000-01-02 03:04:05Z",
1574            &[
1575                num(Year), Literal("-"), num(Month), Literal("-"), num(Day), Space(" "),
1576                num(Hour), Literal(":"), num(Minute), Literal(":"), num(Second),
1577                internal_fixed(TimezoneOffsetPermissive)
1578            ],
1579            parsed!(
1580                year: 2000, month: 1, day: 2, hour_div_12: 0, hour_mod_12: 3, minute: 4, second: 5,
1581                offset: 0
1582            ),
1583        );
1584    }
1585
1586    #[track_caller]
1587    fn parses(s: &str, items: &[Item]) {
1588        let mut parsed = Parsed::new();
1589        assert!(parse(&mut parsed, s, items.iter()).is_ok());
1590    }
1591
1592    #[track_caller]
1593    fn check(s: &str, items: &[Item], expected: ParseResult<Parsed>) {
1594        let mut parsed = Parsed::new();
1595        let result = parse(&mut parsed, s, items.iter());
1596        let parsed = result.map(|_| parsed);
1597        assert_eq!(parsed, expected);
1598    }
1599
1600    #[test]
1601    fn test_rfc2822() {
1602        let ymd_hmsn = |y, m, d, h, n, s, nano, off| {
1603            FixedOffset::east_opt(off * 60 * 60)
1604                .unwrap()
1605                .with_ymd_and_hms(y, m, d, h, n, s)
1606                .unwrap()
1607                .with_nanosecond(nano)
1608                .unwrap()
1609        };
1610
1611        // Test data - (input, Ok(expected result) or Err(error code))
1612        let testdates = [
1613            ("Tue, 20 Jan 2015 17:35:20 -0800", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8))), // normal case
1614            ("Fri,  2 Jan 2015 17:35:20 -0800", Ok(ymd_hmsn(2015, 1, 2, 17, 35, 20, 0, -8))), // folding whitespace
1615            ("Fri, 02 Jan 2015 17:35:20 -0800", Ok(ymd_hmsn(2015, 1, 2, 17, 35, 20, 0, -8))), // leading zero
1616            ("Tue, 20 Jan 2015 17:35:20 -0800 (UTC)", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8))), // trailing comment
1617            (
1618                r"Tue, 20 Jan 2015 17:35:20 -0800 ( (UTC ) (\( (a)\(( \t ) ) \\( \) ))",
1619                Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8)),
1620            ), // complex trailing comment
1621            (r"Tue, 20 Jan 2015 17:35:20 -0800 (UTC\)", Err(TOO_LONG)), // incorrect comment, not enough closing parentheses
1622            (
1623                "Tue, 20 Jan 2015 17:35:20 -0800 (UTC)\t \r\n(Anothercomment)",
1624                Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8)),
1625            ), // multiple comments
1626            ("Tue, 20 Jan 2015 17:35:20 -0800 (UTC) ", Err(TOO_LONG)), // trailing whitespace after comment
1627            ("20 Jan 2015 17:35:20 -0800", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8))), // no day of week
1628            ("20 JAN 2015 17:35:20 -0800", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8))), // upper case month
1629            ("Tue, 20 Jan 2015 17:35 -0800", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 0, 0, -8))), // no second
1630            ("11 Sep 2001 09:45:00 +0000", Ok(ymd_hmsn(2001, 9, 11, 9, 45, 0, 0, 0))),
1631            ("11 Sep 2001 09:45:00 EST", Ok(ymd_hmsn(2001, 9, 11, 9, 45, 0, 0, -5))),
1632            ("11 Sep 2001 09:45:00 GMT", Ok(ymd_hmsn(2001, 9, 11, 9, 45, 0, 0, 0))),
1633            ("30 Feb 2015 17:35:20 -0800", Err(OUT_OF_RANGE)), // bad day of month
1634            ("Tue, 20 Jan 2015", Err(TOO_SHORT)),              // omitted fields
1635            ("Tue, 20 Avr 2015 17:35:20 -0800", Err(INVALID)), // bad month name
1636            ("Tue, 20 Jan 2015 25:35:20 -0800", Err(OUT_OF_RANGE)), // bad hour
1637            ("Tue, 20 Jan 2015 7:35:20 -0800", Err(INVALID)),  // bad # of digits in hour
1638            ("Tue, 20 Jan 2015 17:65:20 -0800", Err(OUT_OF_RANGE)), // bad minute
1639            ("Tue, 20 Jan 2015 17:35:90 -0800", Err(OUT_OF_RANGE)), // bad second
1640            ("Tue, 20 Jan 2015 17:35:20 -0890", Err(OUT_OF_RANGE)), // bad offset
1641            ("6 Jun 1944 04:00:00Z", Err(INVALID)),            // bad offset (zulu not allowed)
1642            ("Tue, 20 Jan 2015 17:35:20 HAS", Err(NOT_ENOUGH)), // bad named time zone
1643            // named timezones that have specific timezone offsets
1644            // see https://www.rfc-editor.org/rfc/rfc2822#section-4.3
1645            ("Tue, 20 Jan 2015 17:35:20 GMT", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, 0))),
1646            ("Tue, 20 Jan 2015 17:35:20 UT", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, 0))),
1647            ("Tue, 20 Jan 2015 17:35:20 ut", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, 0))),
1648            ("Tue, 20 Jan 2015 17:35:20 EDT", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -4))),
1649            ("Tue, 20 Jan 2015 17:35:20 EST", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -5))),
1650            ("Tue, 20 Jan 2015 17:35:20 CDT", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -5))),
1651            ("Tue, 20 Jan 2015 17:35:20 CST", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -6))),
1652            ("Tue, 20 Jan 2015 17:35:20 MDT", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -6))),
1653            ("Tue, 20 Jan 2015 17:35:20 MST", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -7))),
1654            ("Tue, 20 Jan 2015 17:35:20 PDT", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -7))),
1655            ("Tue, 20 Jan 2015 17:35:20 PST", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8))),
1656            ("Tue, 20 Jan 2015 17:35:20 pst", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8))),
1657            // named single-letter military timezones must fallback to +0000
1658            ("Tue, 20 Jan 2015 17:35:20 Z", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, 0))),
1659            ("Tue, 20 Jan 2015 17:35:20 A", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, 0))),
1660            ("Tue, 20 Jan 2015 17:35:20 a", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, 0))),
1661            ("Tue, 20 Jan 2015 17:35:20 K", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, 0))),
1662            ("Tue, 20 Jan 2015 17:35:20 k", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, 0))),
1663            // named single-letter timezone "J" is specifically not valid
1664            ("Tue, 20 Jan 2015 17:35:20 J", Err(NOT_ENOUGH)),
1665            ("Tue, 20 Jan 2015 17:35:20 -0890", Err(OUT_OF_RANGE)), // bad offset minutes
1666            ("Tue, 20 Jan 2015 17:35:20Z", Err(INVALID)),           // bad offset: zulu not allowed
1667            ("Tue, 20 Jan 2015 17:35:20 Zulu", Err(NOT_ENOUGH)),    // bad offset: zulu not allowed
1668            ("Tue, 20 Jan 2015 17:35:20 ZULU", Err(NOT_ENOUGH)),    // bad offset: zulu not allowed
1669            ("Tue, 20 Jan 2015 17:35:20 βˆ’0800", Err(INVALID)), // bad offset: timezone offset using MINUS SIGN (U+2212), not specified for RFC 2822
1670            ("Tue, 20 Jan 2015 17:35:20 0800", Err(INVALID)),  // missing offset sign
1671            ("Tue, 20 Jan 2015 17:35:20 HAS", Err(NOT_ENOUGH)), // bad named timezone
1672            ("Tue, 20 Jan 2015😈17:35:20 -0800", Err(INVALID)), // bad character!
1673        ];
1674
1675        fn rfc2822_to_datetime(date: &str) -> ParseResult<DateTime<FixedOffset>> {
1676            let mut parsed = Parsed::new();
1677            parse(&mut parsed, date, [Item::Fixed(Fixed::RFC2822)].iter())?;
1678            parsed.to_datetime()
1679        }
1680
1681        // Test against test data above
1682        for &(date, checkdate) in testdates.iter() {
1683            #[cfg(feature = "std")]
1684            eprintln!("Test input: {:?}\n    Expect: {:?}", date, checkdate);
1685            let dt = rfc2822_to_datetime(date); // parse a date
1686            if dt != checkdate {
1687                // check for expected result
1688                panic!(
1689                    "Date conversion failed for {}\nReceived: {:?}\nExpected: {:?}",
1690                    date, dt, checkdate
1691                );
1692            }
1693        }
1694    }
1695
1696    #[test]
1697    fn parse_rfc850() {
1698        static RFC850_FMT: &str = "%A, %d-%b-%y %T GMT";
1699
1700        let dt = Utc.with_ymd_and_hms(1994, 11, 6, 8, 49, 37).unwrap();
1701
1702        // Check that the format is what we expect
1703        #[cfg(any(feature = "alloc", feature = "std"))]
1704        assert_eq!(dt.format(RFC850_FMT).to_string(), "Sunday, 06-Nov-94 08:49:37 GMT");
1705
1706        // Check that it parses correctly
1707        assert_eq!(
1708            NaiveDateTime::parse_from_str("Sunday, 06-Nov-94 08:49:37 GMT", RFC850_FMT),
1709            Ok(dt.naive_utc())
1710        );
1711
1712        // Check that the rest of the weekdays parse correctly (this test originally failed because
1713        // Sunday parsed incorrectly).
1714        let testdates = [
1715            (
1716                Utc.with_ymd_and_hms(1994, 11, 7, 8, 49, 37).unwrap(),
1717                "Monday, 07-Nov-94 08:49:37 GMT",
1718            ),
1719            (
1720                Utc.with_ymd_and_hms(1994, 11, 8, 8, 49, 37).unwrap(),
1721                "Tuesday, 08-Nov-94 08:49:37 GMT",
1722            ),
1723            (
1724                Utc.with_ymd_and_hms(1994, 11, 9, 8, 49, 37).unwrap(),
1725                "Wednesday, 09-Nov-94 08:49:37 GMT",
1726            ),
1727            (
1728                Utc.with_ymd_and_hms(1994, 11, 10, 8, 49, 37).unwrap(),
1729                "Thursday, 10-Nov-94 08:49:37 GMT",
1730            ),
1731            (
1732                Utc.with_ymd_and_hms(1994, 11, 11, 8, 49, 37).unwrap(),
1733                "Friday, 11-Nov-94 08:49:37 GMT",
1734            ),
1735            (
1736                Utc.with_ymd_and_hms(1994, 11, 12, 8, 49, 37).unwrap(),
1737                "Saturday, 12-Nov-94 08:49:37 GMT",
1738            ),
1739        ];
1740
1741        for val in &testdates {
1742            assert_eq!(NaiveDateTime::parse_from_str(val.1, RFC850_FMT), Ok(val.0.naive_utc()));
1743        }
1744
1745        let test_dates_fail = [
1746            "Saturday, 12-Nov-94 08:49:37",
1747            "Saturday, 12-Nov-94 08:49:37 Z",
1748            "Saturday, 12-Nov-94 08:49:37 GMTTTT",
1749            "Saturday, 12-Nov-94 08:49:37 gmt",
1750            "Saturday, 12-Nov-94 08:49:37 +08:00",
1751            "Caturday, 12-Nov-94 08:49:37 GMT",
1752            "Saturday, 99-Nov-94 08:49:37 GMT",
1753            "Saturday, 12-Nov-2000 08:49:37 GMT",
1754            "Saturday, 12-Mop-94 08:49:37 GMT",
1755            "Saturday, 12-Nov-94 28:49:37 GMT",
1756            "Saturday, 12-Nov-94 08:99:37 GMT",
1757            "Saturday, 12-Nov-94 08:49:99 GMT",
1758        ];
1759
1760        for val in &test_dates_fail {
1761            assert!(NaiveDateTime::parse_from_str(val, RFC850_FMT).is_err());
1762        }
1763    }
1764
1765    #[test]
1766    fn test_rfc3339() {
1767        let ymd_hmsn = |y, m, d, h, n, s, nano, off| {
1768            FixedOffset::east_opt(off * 60 * 60)
1769                .unwrap()
1770                .with_ymd_and_hms(y, m, d, h, n, s)
1771                .unwrap()
1772                .with_nanosecond(nano)
1773                .unwrap()
1774        };
1775
1776        // Test data - (input, Ok(expected result) or Err(error code))
1777        let testdates = [
1778            ("2015-01-20T17:35:20-08:00", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8))), // normal case
1779            ("2015-01-20T17:35:20βˆ’08:00", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8))), // normal case with MINUS SIGN (U+2212)
1780            ("1944-06-06T04:04:00Z", Ok(ymd_hmsn(1944, 6, 6, 4, 4, 0, 0, 0))),           // D-day
1781            ("2001-09-11T09:45:00-08:00", Ok(ymd_hmsn(2001, 9, 11, 9, 45, 0, 0, -8))),
1782            ("2015-01-20T17:35:20.001-08:00", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 1_000_000, -8))),
1783            ("2015-01-20T17:35:20.001βˆ’08:00", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 1_000_000, -8))), // with MINUS SIGN (U+2212)
1784            ("2015-01-20T17:35:20.000031-08:00", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 31_000, -8))),
1785            ("2015-01-20T17:35:20.000000004-08:00", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 4, -8))),
1786            ("2015-01-20T17:35:20.000000004βˆ’08:00", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 4, -8))), // with MINUS SIGN (U+2212)
1787            (
1788                "2015-01-20T17:35:20.000000000452-08:00",
1789                Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8)),
1790            ), // too small
1791            (
1792                "2015-01-20T17:35:20.000000000452βˆ’08:00",
1793                Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8)),
1794            ), // too small with MINUS SIGN (U+2212)
1795            ("2015-01-20 17:35:20-08:00", Ok(ymd_hmsn(2015, 1, 20, 17, 35, 20, 0, -8))), // without 'T'
1796            ("2015/01/20T17:35:20.001-08:00", Err(INVALID)), // wrong separator char YMD
1797            ("2015-01-20T17-35-20.001-08:00", Err(INVALID)), // wrong separator char HMS
1798            ("-01-20T17:35:20-08:00", Err(INVALID)),         // missing year
1799            ("99-01-20T17:35:20-08:00", Err(INVALID)),       // bad year format
1800            ("99999-01-20T17:35:20-08:00", Err(INVALID)),    // bad year value
1801            ("-2000-01-20T17:35:20-08:00", Err(INVALID)),    // bad year value
1802            ("2015-02-30T17:35:20-08:00", Err(OUT_OF_RANGE)), // bad day of month value
1803            ("2015-01-20T25:35:20-08:00", Err(OUT_OF_RANGE)), // bad hour value
1804            ("2015-01-20T17:65:20-08:00", Err(OUT_OF_RANGE)), // bad minute value
1805            ("2015-01-20T17:35:90-08:00", Err(OUT_OF_RANGE)), // bad second value
1806            ("2015-01-20T17:35:20-24:00", Err(OUT_OF_RANGE)), // bad offset value
1807            ("15-01-20T17:35:20-08:00", Err(INVALID)),       // bad year format
1808            ("15-01-20T17:35:20-08:00:00", Err(INVALID)),    // bad year format, bad offset format
1809            ("2015-01-20T17:35:2008:00", Err(INVALID)),      // missing offset sign
1810            ("2015-01-20T17:35:20 08:00", Err(INVALID)),     // missing offset sign
1811            ("2015-01-20T17:35:20Zulu", Err(TOO_LONG)),      // bad offset format
1812            ("2015-01-20T17:35:20 Zulu", Err(INVALID)),      // bad offset format
1813            ("2015-01-20T17:35:20GMT", Err(INVALID)),        // bad offset format
1814            ("2015-01-20T17:35:20 GMT", Err(INVALID)),       // bad offset format
1815            ("2015-01-20T17:35:20+GMT", Err(INVALID)),       // bad offset format
1816            ("2015-01-20T17:35:20++08:00", Err(INVALID)),    // bad offset format
1817            ("2015-01-20T17:35:20--08:00", Err(INVALID)),    // bad offset format
1818            ("2015-01-20T17:35:20βˆ’βˆ’08:00", Err(INVALID)), // bad offset format with MINUS SIGN (U+2212)
1819            ("2015-01-20T17:35:20Β±08:00", Err(INVALID)),  // bad offset sign
1820            ("2015-01-20T17:35:20-08-00", Err(INVALID)),  // bad offset separator
1821            ("2015-01-20T17:35:20-08;00", Err(INVALID)),  // bad offset separator
1822            ("2015-01-20T17:35:20-0800", Err(INVALID)),   // bad offset separator
1823            ("2015-01-20T17:35:20-08:0", Err(TOO_SHORT)), // bad offset minutes
1824            ("2015-01-20T17:35:20-08:AA", Err(INVALID)),  // bad offset minutes
1825            ("2015-01-20T17:35:20-08:ZZ", Err(INVALID)),  // bad offset minutes
1826            ("2015-01-20T17:35:20.001-08 : 00", Err(INVALID)), // bad offset separator
1827            ("2015-01-20T17:35:20-08:00:00", Err(TOO_LONG)), // bad offset format
1828            ("2015-01-20T17:35:20+08:", Err(TOO_SHORT)),  // bad offset format
1829            ("2015-01-20T17:35:20-08:", Err(TOO_SHORT)),  // bad offset format
1830            ("2015-01-20T17:35:20βˆ’08:", Err(TOO_SHORT)), // bad offset format with MINUS SIGN (U+2212)
1831            ("2015-01-20T17:35:20-08", Err(TOO_SHORT)),  // bad offset format
1832            ("2015-01-20T", Err(TOO_SHORT)),             // missing HMS
1833            ("2015-01-20T00:00:1", Err(TOO_SHORT)),      // missing complete S
1834            ("2015-01-20T00:00:1-08:00", Err(INVALID)),  // missing complete S
1835        ];
1836
1837        // Test against test data above
1838        for &(date, checkdate) in testdates.iter() {
1839            let dt = DateTime::<FixedOffset>::parse_from_rfc3339(date);
1840            if dt != checkdate {
1841                // check for expected result
1842                panic!(
1843                    "Date conversion failed for {}\nReceived: {:?}\nExpected: {:?}",
1844                    date, dt, checkdate
1845                );
1846            }
1847        }
1848    }
1849
1850    #[test]
1851    fn test_issue_1010() {
1852        let dt = crate::NaiveDateTime::parse_from_str("\u{c}SUN\u{e}\u{3000}\0m@J\u{3000}\0\u{3000}\0m\u{c}!\u{c}\u{b}\u{c}\u{c}\u{c}\u{c}%A\u{c}\u{b}\0SU\u{c}\u{c}",
1853        "\u{c}\u{c}%A\u{c}\u{b}\0SUN\u{c}\u{c}\u{c}SUNN\u{c}\u{c}\u{c}SUN\u{c}\u{c}!\u{c}\u{b}\u{c}\u{c}\u{c}\u{c}%A\u{c}\u{b}%a");
1854        assert_eq!(dt, Err(ParseError(ParseErrorKind::Invalid)));
1855    }
1856}