1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
// This file is part of ICU4X. For terms of use, please see the file
// called LICENSE at the top level of the ICU4X source tree
// (online at: https://github.com/unicode-org/icu4x/blob/main/LICENSE ).
use crate::{fields::Field, pattern::PatternLoadError};
use displaydoc::Display;
use icu_calendar::{
any_calendar::AnyCalendarKind,
types::{FormattingEra, MonthCode},
};
use icu_provider::DataError;
#[cfg(doc)]
use crate::pattern::TypedDateTimeNames;
#[cfg(doc)]
use icu_calendar::types::YearInfo;
#[cfg(doc)]
use icu_decimal::FixedDecimalFormatter;
/// An error from constructing a formatter.
#[derive(Display, Debug, Copy, Clone, PartialEq)]
#[non_exhaustive]
pub enum DateTimeFormatterLoadError {
/// An error while loading display names for a field.
#[displaydoc("{0}")]
Names(PatternLoadError),
/// An error while loading some other required data,
/// such as skeleton patterns or calendar conversions.
#[displaydoc("{0}")]
Data(DataError),
}
/// An error from mixing calendar types in a formatter.
#[derive(Display, Debug, Copy, Clone, PartialEq)]
#[displaydoc("DateTimeFormatter for {this_kind} calendar was given a {date_kind:?} calendar")]
#[non_exhaustive]
pub struct MismatchedCalendarError {
/// The calendar kind of the target object (formatter).
pub this_kind: AnyCalendarKind,
/// The calendar kind of the input object (date being formatted).
/// Can be `None` if the input calendar was not specified.
pub date_kind: Option<AnyCalendarKind>,
}
#[non_exhaustive]
#[derive(Debug, PartialEq, Copy, Clone, displaydoc::Display)]
/// Error for `TryWriteable` implementations
pub enum DateTimeWriteError {
/// The [`MonthCode`] of the input is not valid for this calendar.
///
/// This is guaranteed not to happen for `icu::calendar` inputs, but may happen for custom inputs.
///
/// The output will contain the raw [`MonthCode`] as a fallback value.
#[displaydoc("Invalid month {0:?}")]
InvalidMonthCode(MonthCode),
/// The [`FormattingEra`] of the input is not valid for this calendar.
///
/// This is guaranteed not to happen for `icu::calendar` inputs, but may happen for custom inputs.
///
/// The output will contain [`FormattingEra::fallback_name`] as the fallback.
#[displaydoc("Invalid era {0:?}")]
InvalidEra(FormattingEra),
/// The [`YearInfo::cyclic`] of the input is not valid for this calendar.
///
/// This is guaranteed not to happen for `icu::calendar` inputs, but may happen for custom inputs.
///
/// The output will contain [`YearInfo::extended_year`] as a fallback value.
#[displaydoc("Invalid cyclic year {value} (maximum {max})")]
InvalidCyclicYear {
/// Value
value: usize,
/// Max
max: usize,
},
/// The [`FixedDecimalFormatter`] has not been loaded.
///
/// This *only* happens if the formatter has been created using
/// [`TypedDateTimeNames::with_pattern_unchecked`], the pattern requires decimal
/// formatting, and the decimal formatter was not loaded.
///
/// The output will contain fallback values using Latin numerals.
#[displaydoc("FixedDecimalFormatter not loaded")]
FixedDecimalFormatterNotLoaded,
/// The localized names for a field have not been loaded.
///
/// This *only* happens if the formatter has been created using
/// [`TypedDateTimeNames::with_pattern_unchecked`], and the pattern requires names
/// that were not loaded.
///
/// The output will contain fallback values using field identifiers (such as `tue` for `IsoWeekday::Tuesday`,
/// `M02` for month 2, etc.).
#[displaydoc("Names for {0:?} not loaded")]
NamesNotLoaded(Field),
/// An input field (such as "hour" or "month") is missing.
///
/// This *only* happens if the formatter has been created using
/// [`TypedDateTimeNames::with_pattern_unchecked`], and the pattern requires fields
/// that are not returned by the input type.
///
/// The output will contain the string `{X}` instead, where `X` is the symbol for which the input is missing.
#[displaydoc("Incomplete input, missing value for {0:?}")]
MissingInputField(&'static str),
/// Unsupported field
///
/// This *only* happens if the formatter has been created using
/// [`TypedDateTimeNames::with_pattern_unchecked`], and the pattern contains unsupported fields.
///
/// The output will contain the string `{unsupported:X}`, where `X` is the symbol of the unsupported field.
#[displaydoc("Unsupported field {0:?}")]
UnsupportedField(Field),
}