utc2k 0.19.1

A fast and lean UTC date/time library concerned only with happenings in this century (2000-2099).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

/*!
# UTC2K - Errors.
*/

use crate::macros;
use std::error::Error;



/// # Helper: Errors.
macro_rules! err {
	( $( $k:ident $v:literal ),+ $(,)? ) => (
		#[derive(Debug, Copy, Clone, Eq, PartialEq)]
		/// # Errors.
		pub enum Utc2kError {
			$(
				#[doc = concat!("# ", $v)]
				$k,
			)+
		}

		impl Utc2kError {
			#[must_use]
			/// # As Str.
			///
			/// Return the error as a string slice.
			pub const fn as_str(self) -> &'static str {
				match self {
					$( Self::$k => $v, )+
				}
			}
		}
	);
}

err! {
	Invalid   "Invalid date/time format.",
	Overflow  "Date/time is post-2099.",
	Underflow "Date/time is pre-2000.",
}

impl Error for Utc2kError {}

macros::as_ref_borrow_cast!(Utc2kError: as_str str);
macros::display_str!(as_str Utc2kError);



#[derive(Debug, Clone, Copy, Eq, PartialEq)]
/// # Formatting Error.
pub enum Utc2kFormatError {
	/// # Unexpected End.
	Eof,

	/// # Invalid Component.
	InvalidComponent,

	/// # Invalid Year Modifier.
	InvalidModifier(&'static str),

	/// # Format String Not ASCII.
	NotAscii,
}

impl Error for Utc2kFormatError {}

impl Utc2kFormatError {
	#[must_use]
	/// # As String Slice.
	///
	/// Same as `Display`, but `const`.
	pub const fn as_str(self) -> &'static str {
		match self {
			Self::Eof => "Expected ']'.",
			Self::InvalidComponent => "Expected [year | month | day | hour | minute | second | ordinal | period | unixtime].",
			Self::InvalidModifier(s) => s,
			Self::NotAscii => "Date format strings must be ASCII.",
		}
	}
}

macros::as_ref_borrow_cast!(Utc2kFormatError: as_str str);
macros::display_str!(as_str Utc2kFormatError);