time 0.3.51

Date and time library. Fully interoperable with the standard library. Mostly compatible with #![no_std].
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

use core::cmp::Ordering;
use core::ops::Sub;

#[allow(unused_imports)] // MSRV of 1.87
use num_conv::prelude::*;

use crate::{Duration, OffsetDateTime, Timestamp};

impl Sub<OffsetDateTime> for Timestamp {
    type Output = Duration;

    #[inline]
    fn sub(self, rhs: OffsetDateTime) -> Self::Output {
        Duration::new(
            self.as_seconds() - rhs.unix_timestamp(),
            self.nanosecond().cast_signed() - rhs.nanosecond().cast_signed(),
        )
    }
}

impl Sub<Timestamp> for OffsetDateTime {
    type Output = Duration;

    #[inline]
    fn sub(self, rhs: Timestamp) -> Self::Output {
        Duration::new(
            self.unix_timestamp() - rhs.as_seconds(),
            self.nanosecond().cast_signed() - rhs.nanosecond().cast_signed(),
        )
    }
}

impl PartialEq<OffsetDateTime> for Timestamp {
    #[expect(clippy::suspicious_operation_groupings, reason = "false positive")]
    #[inline]
    fn eq(&self, other: &OffsetDateTime) -> bool {
        self.as_seconds() == other.unix_timestamp() && self.nanosecond() == other.nanosecond()
    }
}

impl PartialEq<Timestamp> for OffsetDateTime {
    #[inline]
    fn eq(&self, other: &Timestamp) -> bool {
        other == self
    }
}

impl PartialOrd<OffsetDateTime> for Timestamp {
    #[inline]
    fn partial_cmp(&self, other: &OffsetDateTime) -> Option<Ordering> {
        (self.as_seconds(), self.nanosecond())
            .partial_cmp(&(other.unix_timestamp(), other.nanosecond()))
    }
}

impl PartialOrd<Timestamp> for OffsetDateTime {
    #[inline]
    fn partial_cmp(&self, other: &Timestamp) -> Option<Ordering> {
        other.partial_cmp(self).map(Ordering::reverse)
    }
}

impl From<OffsetDateTime> for Timestamp {
    /// # Panics
    ///
    /// This may panic if an overflow occurs.
    #[inline]
    #[track_caller]
    fn from(datetime: OffsetDateTime) -> Self {
        // Safety: Nanoseconds have the same range.
        unsafe {
            Self::from_seconds(datetime.unix_timestamp())
                .expect("local datetime out of valid range for `Timestamp`")
                .replace_nanosecond(datetime.nanosecond())
                .unwrap_unchecked()
        }
    }
}

impl From<Timestamp> for OffsetDateTime {
    #[inline]
    fn from(timestamp: Timestamp) -> Self {
        // Safety: The valid range of `Timestamp` is less than that of `OffsetDateTime` (due to edge
        // cases of `OffsetDateTime`). Nanoseconds have the same range.
        unsafe {
            Self::from_unix_timestamp(timestamp.as_seconds())
                .unwrap_unchecked()
                .replace_nanosecond(timestamp.nanosecond())
                .unwrap_unchecked()
        }
    }
}