kron-lib 2.1.0

Date/time library
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
100
101
102
103
104
105
106

#![doc = include_str!("../README.md")]

//--------------------------------------------------------------------------------------------------

use anyhow::{anyhow, Result};
use lazy_static::lazy_static;
use time::OffsetDateTime;

//--------------------------------------------------------------------------------------------------

pub const FMT_COMPACT: &str = "[year][month][day]-[hour][minute][second]Z";
pub const FMT_ISO8601: &str = "[year]-[month]-[day]T[hour]:[minute]:[second]Z";
pub const FMT_ISO8601NS: &str = "[year]-[month]-[day]T[hour]:[minute]:[second].[subsecond digits:9]Z";

//--------------------------------------------------------------------------------------------------

lazy_static! {
    pub static ref COMPACT: KronFormat<'static> = KronFormat::new(FMT_COMPACT).unwrap();
    pub static ref ISO8601: KronFormat<'static> = KronFormat::new(FMT_ISO8601).unwrap();
    pub static ref ISO8601NS: KronFormat<'static> = KronFormat::new(FMT_ISO8601NS).unwrap();
}

//--------------------------------------------------------------------------------------------------

#[cfg(test)]
mod tests;

//--------------------------------------------------------------------------------------------------

#[derive(Clone)]
pub struct KronFormat<'a> {
    fmt: Vec<time::format_description::FormatItem<'a>>,
}

impl KronFormat<'_> {
    pub fn new(s: &str) -> Result<KronFormat> {
        Ok(KronFormat {
            fmt: time::format_description::parse(s)?,
        })
    }

    pub fn from(s: &str) -> Result<KronFormat> {
        match s {
            "COMPACT" => Ok(COMPACT.clone()),
            "ISO8601" => Ok(ISO8601.clone()),
            "ISO8601NS" => Ok(ISO8601NS.clone()),
            _ => KronFormat::new(s),
            //_ => Err(anyhow!("Invalid format: {s:?}")),
        }
    }
}

//--------------------------------------------------------------------------------------------------

pub struct Kron {
    pub dt: OffsetDateTime,
}

impl Kron {
    pub fn now() -> Kron {
        Kron {
            dt: OffsetDateTime::now_utc(),
        }
    }

    pub fn from(s: &str) -> Result<Kron> {
        if s.contains('.') && s.parse::<f64>().is_ok() {
            let mut p = s.split('.');
            let mut ts = Kron::timestamp(p.next().unwrap().parse::<i64>()?)?;
            let mut nanos = p.next().unwrap().to_string();
            while nanos.len() < 9 {
                nanos.push('0');
            }
            ts.dt = ts.dt.replace_nanosecond(nanos.parse::<u32>()?)?;
            Ok(ts)
        } else if let Ok(n) = s.parse::<i64>() {
            Kron::timestamp(n)
        } else {
            Err(anyhow!("Invalid timestamp: {s:?}"))
        }
    }

    pub fn timestamp(n: i64) -> Result<Kron> {
        Ok(Kron {
            dt: OffsetDateTime::from_unix_timestamp(n)?,
        })
    }

    pub fn epoch() -> Kron {
        Kron::timestamp(0).unwrap()
    }

    pub fn format(&self, f: &KronFormat) -> Result<String> {
        Ok(self.dt.format(&f.fmt)?)
    }

    pub fn format_str(&self, s: &'static str) -> Result<String> {
        self.format(&KronFormat::new(s)?)
    }
}

impl std::fmt::Display for Kron {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        write!(f, "{}", self.dt.format(&ISO8601.fmt).unwrap())
    }
}