date-differencer 0.2.2

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
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

use chrono::{DateTime, Datelike, NaiveDateTime, Offset, Timelike};

use super::DateTimeParts;

impl<Tz> DateTimeParts for DateTime<Tz>
where
    Tz: chrono::TimeZone,
    DateTime<Tz>: Ord,
{
    #[inline]
    fn year(&self) -> i32 {
        Datelike::year(self)
    }

    #[inline]
    fn month(&self) -> u8 {
        Datelike::month(self) as u8
    }

    #[inline]
    fn day(&self) -> u8 {
        Datelike::day(self) as u8
    }

    #[inline]
    fn hour(&self) -> u8 {
        Timelike::hour(self) as u8
    }

    #[inline]
    fn minute(&self) -> u8 {
        Timelike::minute(self) as u8
    }

    #[inline]
    fn second(&self) -> u8 {
        Timelike::second(self) as u8
    }

    #[inline]
    fn nanosecond(&self) -> u32 {
        // chrono represents a leap second with 1_000_000_000 or more nanoseconds, so treat it as the last nanosecond of the second.
        Timelike::nanosecond(self).min(999_999_999)
    }

    #[inline]
    fn all_parts(&self) -> (i32, u8, u8, u8, u8, u8, u32) {
        // Calculate the local date-time only once instead of once per field.
        self.naive_local().all_parts()
    }

    #[inline]
    fn to_same_time_zone(&self, other: Self) -> Self {
        // Looking up a time zone such as `Local` is slow, so skip the conversion when the offsets are already the same.
        if self.offset().fix() == other.offset().fix() {
            other
        } else {
            other.with_timezone(&self.timezone())
        }
    }
}

impl DateTimeParts for NaiveDateTime {
    #[inline]
    fn year(&self) -> i32 {
        Datelike::year(self)
    }

    #[inline]
    fn month(&self) -> u8 {
        Datelike::month(self) as u8
    }

    #[inline]
    fn day(&self) -> u8 {
        Datelike::day(self) as u8
    }

    #[inline]
    fn hour(&self) -> u8 {
        Timelike::hour(self) as u8
    }

    #[inline]
    fn minute(&self) -> u8 {
        Timelike::minute(self) as u8
    }

    #[inline]
    fn second(&self) -> u8 {
        Timelike::second(self) as u8
    }

    #[inline]
    fn nanosecond(&self) -> u32 {
        // chrono represents a leap second with 1_000_000_000 or more nanoseconds, so treat it as the last nanosecond of the second.
        Timelike::nanosecond(self).min(999_999_999)
    }
}