packedtime-rs 0.3.2

Utilities for efficiently storing, parsing, formatting and truncating 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
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 crate::{EpochDays, PackedTimestamp, MILLIS_PER_DAY};

/// Internal struct containing the components of a DateTime as separate fields.
#[derive(PartialEq, Clone, Debug, Default)]
pub(crate) struct DateTimeComponents {
    pub year: i32,
    pub month: u8,
    pub day: u8,
    pub hour: u8,
    pub minute: u8,
    pub second: u8,
    pub millisecond: u32,
    pub offset_minute: i32,
}

impl DateTimeComponents {
    #[inline(always)]
    pub(crate) fn from_timestamp_millis(ts: i64) -> Self {
        let epoch_days = ts.div_euclid(MILLIS_PER_DAY) as i32;
        let milli_of_day = ts.rem_euclid(MILLIS_PER_DAY) as u32;
        let millisecond = milli_of_day % 1000;
        let second_of_day = milli_of_day / 1000;
        let second = second_of_day % 60;
        let minute_of_day = second_of_day / 60;
        let minute = minute_of_day % 60;
        let hour_of_day = minute_of_day / 60;

        let (year, month, day) = EpochDays::new(epoch_days).to_ymd();

        Self {
            year,
            month: month as _,
            day: day as _,
            hour: hour_of_day as _,
            minute: minute as _,
            second: second as _,
            millisecond,
            offset_minute: 0,
        }
    }

    #[inline(always)]
    pub(crate) fn new(year: i32, month: u8, day: u8, hour: u8, minute: u8, second: u8, millisecond: u32) -> Self {
        Self {
            year,
            month,
            day,
            hour,
            minute,
            second,
            millisecond,
            offset_minute: 0,
        }
    }

    #[inline(always)]
    pub(crate) fn new_with_offset_minute(
        year: i32,
        month: u8,
        day: u8,
        hour: u8,
        minute: u8,
        second: u8,
        millisecond: u32,
        offset_minute: i32,
    ) -> Self {
        Self {
            year,
            month,
            day,
            hour,
            minute,
            second,
            millisecond,
            offset_minute,
        }
    }

    #[inline(always)]
    pub(crate) fn to_packed(&self) -> PackedTimestamp {
        PackedTimestamp::new(
            self.year as _,
            self.month as _,
            self.day as _,
            self.hour as _,
            self.minute as _,
            self.second as _,
            self.millisecond as _,
            self.offset_minute,
        )
    }
}