date-differencer 0.2.0

Calculate the time interval between two supported date-time values and output the result in years plus months plus days plus hours plus minutes plus seconds plus nanoseconds (instead of representing the same duration in different units). This library is useful for lifespan check and age calculation.
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

use time::{Date, Month, OffsetDateTime, PrimitiveDateTime, Time, UtcDateTime};

use super::{AddDateTimeDiff, AddedDateTimeParts, DateTimeDiff, add_date_time_parts};

#[inline]
fn date_time_from_parts(parts: AddedDateTimeParts) -> Option<(Date, Time)> {
    let date =
        Date::from_calendar_date(parts.year, Month::try_from(parts.month).ok()?, parts.day).ok()?;

    let time =
        Time::from_hms_nano(parts.hour, parts.minute, parts.second, parts.nanosecond).ok()?;

    Some((date, time))
}

impl AddDateTimeDiff for PrimitiveDateTime {
    type Output = Option<PrimitiveDateTime>;

    #[inline]
    fn add_date_time_diff(self, date_time_diff: &impl DateTimeDiff) -> Self::Output {
        let (date, time) = date_time_from_parts(add_date_time_parts(&self, date_time_diff)?)?;

        Some(PrimitiveDateTime::new(date, time))
    }
}

impl AddDateTimeDiff for OffsetDateTime {
    type Output = Option<OffsetDateTime>;

    #[inline]
    fn add_date_time_diff(self, date_time_diff: &impl DateTimeDiff) -> Self::Output {
        let (date, time) = date_time_from_parts(add_date_time_parts(&self, date_time_diff)?)?;

        Some(OffsetDateTime::new_in_offset(date, time, self.offset()))
    }
}

impl AddDateTimeDiff for UtcDateTime {
    type Output = Option<UtcDateTime>;

    #[inline]
    fn add_date_time_diff(self, date_time_diff: &impl DateTimeDiff) -> Self::Output {
        let (date, time) = date_time_from_parts(add_date_time_parts(&self, date_time_diff)?)?;

        Some(UtcDateTime::new(date, time))
    }
}