practicaltimestamp 0.1.0

For efficiently handling unix timestamps
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

use super::UnixTimestamp;

#[derive(Debug)]
pub enum TimestampResult {
    TimestampOk(UnixTimestamp),
    OverflowErr(i64),
}

impl TimestampResult {
    #[track_caller] // MSRV 1.46
    pub fn expect(self, msg: &'static str) -> UnixTimestamp {
        match self {
            Self::TimestampOk(timestamp) => timestamp,
            _ => panic!(msg),
        }
    }

    pub const fn ok(self) -> Option<UnixTimestamp> {
        match self {
            Self::TimestampOk(timestamp) => Some(timestamp),
            _ => None,
        }
    }

    pub const fn unwrap(self) -> UnixTimestamp {
        match self {
            Self::TimestampOk(timestamp) => timestamp,
            Self::OverflowErr(value) => {
                // Overflowed timestamp saturates when unwrapped
                if value < UnixTimestamp::MIN.unix_timestamp() {
                    UnixTimestamp::MIN
                } else {
                    UnixTimestamp::MAX
                }
            },
        }
    }
}