pipeline/etl/value/
time.rs

1// Copyright 2023 Greptime Team
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15use chrono::{DateTime, Utc};
16use common_time::timestamp::TimeUnit;
17
18#[derive(Debug, Clone, PartialEq)]
19pub enum Timestamp {
20    Nanosecond(i64),
21    Microsecond(i64),
22    Millisecond(i64),
23    Second(i64),
24}
25
26pub(crate) const NANOSECOND_RESOLUTION: &str = "nanosecond";
27pub(crate) const NANO_RESOLUTION: &str = "nano";
28pub(crate) const NS_RESOLUTION: &str = "ns";
29pub(crate) const MICROSECOND_RESOLUTION: &str = "microsecond";
30pub(crate) const MICRO_RESOLUTION: &str = "micro";
31pub(crate) const US_RESOLUTION: &str = "us";
32pub(crate) const MILLISECOND_RESOLUTION: &str = "millisecond";
33pub(crate) const MILLI_RESOLUTION: &str = "milli";
34pub(crate) const MS_RESOLUTION: &str = "ms";
35pub(crate) const SECOND_RESOLUTION: &str = "second";
36pub(crate) const SEC_RESOLUTION: &str = "sec";
37pub(crate) const S_RESOLUTION: &str = "s";
38
39pub(crate) const VALID_RESOLUTIONS: [&str; 12] = [
40    NANOSECOND_RESOLUTION,
41    NANO_RESOLUTION,
42    NS_RESOLUTION,
43    MICROSECOND_RESOLUTION,
44    MICRO_RESOLUTION,
45    US_RESOLUTION,
46    MILLISECOND_RESOLUTION,
47    MILLI_RESOLUTION,
48    MS_RESOLUTION,
49    SECOND_RESOLUTION,
50    SEC_RESOLUTION,
51    S_RESOLUTION,
52];
53
54impl Timestamp {
55    pub(crate) fn timestamp_nanos(&self) -> i64 {
56        match self {
57            Timestamp::Nanosecond(v) => *v,
58            Timestamp::Microsecond(v) => *v * 1_000,
59            Timestamp::Millisecond(v) => *v * 1_000_000,
60            Timestamp::Second(v) => *v * 1_000_000_000,
61        }
62    }
63
64    pub(crate) fn timestamp_micros(&self) -> i64 {
65        match self {
66            Timestamp::Nanosecond(v) => *v / 1_000,
67            Timestamp::Microsecond(v) => *v,
68            Timestamp::Millisecond(v) => *v * 1_000,
69            Timestamp::Second(v) => *v * 1_000_000,
70        }
71    }
72
73    pub(crate) fn timestamp_millis(&self) -> i64 {
74        match self {
75            Timestamp::Nanosecond(v) => *v / 1_000_000,
76            Timestamp::Microsecond(v) => *v / 1_000,
77            Timestamp::Millisecond(v) => *v,
78            Timestamp::Second(v) => *v * 1_000,
79        }
80    }
81
82    pub(crate) fn timestamp(&self) -> i64 {
83        match self {
84            Timestamp::Nanosecond(v) => *v / 1_000_000_000,
85            Timestamp::Microsecond(v) => *v / 1_000_000,
86            Timestamp::Millisecond(v) => *v / 1_000,
87            Timestamp::Second(v) => *v,
88        }
89    }
90
91    pub(crate) fn to_unit(&self, unit: &TimeUnit) -> i64 {
92        match unit {
93            TimeUnit::Second => self.timestamp(),
94            TimeUnit::Millisecond => self.timestamp_millis(),
95            TimeUnit::Microsecond => self.timestamp_micros(),
96            TimeUnit::Nanosecond => self.timestamp_nanos(),
97        }
98    }
99
100    pub fn get_unit(&self) -> TimeUnit {
101        match self {
102            Timestamp::Nanosecond(_) => TimeUnit::Nanosecond,
103            Timestamp::Microsecond(_) => TimeUnit::Microsecond,
104            Timestamp::Millisecond(_) => TimeUnit::Millisecond,
105            Timestamp::Second(_) => TimeUnit::Second,
106        }
107    }
108
109    pub fn to_datetime(&self) -> Option<DateTime<Utc>> {
110        match self {
111            Timestamp::Nanosecond(v) => Some(DateTime::from_timestamp_nanos(*v)),
112            Timestamp::Microsecond(v) => DateTime::from_timestamp_micros(*v),
113            Timestamp::Millisecond(v) => DateTime::from_timestamp_millis(*v),
114            Timestamp::Second(v) => DateTime::from_timestamp(*v, 0),
115        }
116    }
117
118    pub fn from_datetime(dt: DateTime<Utc>) -> Option<Self> {
119        dt.timestamp_nanos_opt().map(Timestamp::Nanosecond)
120    }
121}
122
123impl Default for Timestamp {
124    fn default() -> Self {
125        Timestamp::Nanosecond(chrono::Utc::now().timestamp_nanos_opt().unwrap_or_default())
126    }
127}
128
129impl std::fmt::Display for Timestamp {
130    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
131        let (value, resolution) = match self {
132            Timestamp::Nanosecond(v) => (v, NANOSECOND_RESOLUTION),
133            Timestamp::Microsecond(v) => (v, MICROSECOND_RESOLUTION),
134            Timestamp::Millisecond(v) => (v, MILLISECOND_RESOLUTION),
135            Timestamp::Second(v) => (v, SECOND_RESOLUTION),
136        };
137
138        write!(f, "{}, resolution: {}", value, resolution)
139    }
140}