Skip to main content

churchtools_api/
datetime.rs

1use std::fmt;
2
3use chrono::{DateTime, NaiveDate, SecondsFormat, Utc};
4use serde::{Deserialize, Serialize, Serializer};
5
6/// Formats a timestamp the way the API accepts it: `2026-11-01T10:00:00Z`.
7///
8/// The server rejects offsets (`+00:00`) and fractional seconds.
9pub fn to_wire(value: &DateTime<Utc>) -> String {
10    value.to_rfc3339_opts(SecondsFormat::Secs, true)
11}
12
13pub(crate) fn serialize_utc<S: Serializer>(value: &DateTime<Utc>, s: S) -> Result<S::Ok, S::Error> {
14    s.serialize_str(&to_wire(value))
15}
16
17pub(crate) fn serialize_opt_utc<S: Serializer>(value: &Option<DateTime<Utc>>, s: S) -> Result<S::Ok, S::Error> {
18    match value {
19        Some(v) => serialize_utc(v, s),
20        None => s.serialize_none(),
21    }
22}
23
24pub(crate) fn serialize_double_opt_utc<S: Serializer>(
25    value: &Option<Option<DateTime<Utc>>>,
26    s: S,
27) -> Result<S::Ok, S::Error> {
28    match value {
29        Some(v) => serialize_opt_utc(v, s),
30        None => s.serialize_none(),
31    }
32}
33
34/// A value that is a date for all-day entries and a UTC timestamp otherwise.
35#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
36#[serde(untagged)]
37pub enum DateOrDateTime {
38    #[serde(serialize_with = "serialize_utc")]
39    DateTime(DateTime<Utc>),
40    Date(NaiveDate),
41}
42
43impl DateOrDateTime {
44    /// The calendar date (in UTC for timestamps).
45    pub fn date(&self) -> NaiveDate {
46        match self {
47            Self::DateTime(dt) => dt.date_naive(),
48            Self::Date(d) => *d,
49        }
50    }
51
52    pub fn is_all_day(&self) -> bool {
53        matches!(self, Self::Date(_))
54    }
55}
56
57/// `1970-01-01`; only there so models can derive `Default` for
58/// `..Default::default()` in struct literals.
59impl Default for DateOrDateTime {
60    fn default() -> Self {
61        Self::Date(NaiveDate::default())
62    }
63}
64
65impl fmt::Display for DateOrDateTime {
66    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
67        match self {
68            Self::DateTime(dt) => dt.fmt(f),
69            Self::Date(d) => d.fmt(f),
70        }
71    }
72}
73
74#[cfg(test)]
75mod tests {
76    use super::*;
77
78    #[test]
79    fn parses_both_forms() {
80        let v: Vec<DateOrDateTime> = serde_json::from_str(r#"["2026-11-01T10:00:00Z", "2026-11-01"]"#).unwrap();
81        assert!(!v[0].is_all_day());
82        assert!(v[1].is_all_day());
83        assert_eq!(v[0].date(), v[1].date());
84    }
85
86    #[test]
87    fn serializes_without_offset_and_fraction() {
88        let at: DateTime<Utc> = "2026-11-01T10:00:00.123+00:00".parse().unwrap();
89        assert_eq!(to_wire(&at), "2026-11-01T10:00:00Z");
90        let v = serde_json::to_string(&[DateOrDateTime::DateTime(at), DateOrDateTime::Date(at.date_naive())]).unwrap();
91        assert_eq!(v, r#"["2026-11-01T10:00:00Z","2026-11-01"]"#);
92    }
93}