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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

use core::fmt;

use jiff::{Zoned, civil::DateTime};

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

#[inline]
fn jiff_error(args: fmt::Arguments<'_>) -> jiff::Error {
    jiff::Error::from_args(args)
}

#[inline]
fn added_date_time_parts(
    from: &impl super::DateTimeParts,
    date_time_diff: &impl DateTimeDiff,
) -> Result<AddedDateTimeParts, jiff::Error> {
    add_date_time_parts(from, date_time_diff).ok_or_else(|| {
        jiff_error(format_args!("date-time addition overflowed before constructing the Jiff value"))
    })
}

#[inline]
fn jiff_year(year: i32) -> Result<i16, jiff::Error> {
    i16::try_from(year)
        .map_err(|_| jiff_error(format_args!("date-time year is outside Jiff's supported range")))
}

impl AddDateTimeDiff for DateTime {
    type Output = Result<DateTime, jiff::Error>;

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

        DateTime::new(
            jiff_year(parts.year)?,
            parts.month as i8,
            parts.day as i8,
            parts.hour as i8,
            parts.minute as i8,
            parts.second as i8,
            parts.nanosecond as i32,
        )
    }
}

impl AddDateTimeDiff for Zoned {
    type Output = Result<Zoned, jiff::Error>;

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

        self.with()
            .year(jiff_year(parts.year)?)
            .month(parts.month as i8)
            .day(parts.day as i8)
            .hour(parts.hour as i8)
            .minute(parts.minute as i8)
            .second(parts.second as i8)
            .subsec_nanosecond(parts.nanosecond as i32)
            .build()
    }
}