kine-core 0.1.1

Correct and human-readable time handling for Rust
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

use core::{fmt::Display, str::FromStr};

use crate::{Calendar, CalendarTime, OffsetTime, Sigil, TimeZone};

use super::InvalidSigilError;

/// The UTC timezone
#[derive(Clone, Copy, PartialEq, Eq)]
pub struct Utc;

/// Sigil for the UTC timezone
///
/// This is only exposed so that it is possible to write the `OffsetTime<UtcSigil>` struct.
#[derive(Clone, Copy, PartialEq, Eq)]
pub struct UtcSigil;

impl TimeZone for Utc {
    type Sigil = UtcSigil;
}

impl Calendar for Utc {
    type Time = OffsetTime<UtcSigil>;

    fn write(&self, t: &crate::Time) -> crate::Result<Self::Time> {
        let t = crate::providers::UTC.write(t)?;
        Ok(Self::Time::from_pseudo_nanos_since_posix_epoch(
            UtcSigil,
            t.as_pseudo_nanos_since_posix_epoch(),
            t.extra_nanos(),
        ))
    }
}

impl Sigil for UtcSigil {
    fn read(&self, t: &OffsetTime<Self>) -> crate::Result<crate::TimeResult> {
        OffsetTime::<crate::providers::UtcSigil>::from_pseudo_nanos_since_posix_epoch(
            crate::providers::UTC_SIGIL,
            t.as_pseudo_nanos_since_posix_epoch(),
            t.extra_nanos(),
        )
        .read()
    }
}

impl Display for UtcSigil {
    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        f.write_str("Z")
    }
}

impl FromStr for UtcSigil {
    type Err = InvalidSigilError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s {
            "Z" => Ok(UtcSigil),
            " UTC" => Ok(UtcSigil),
            _ => Err(InvalidSigilError),
        }
    }
}