deep-time 0.1.0-alpha.6

High-precision, no-std, no-alloc date-time library, leap-seconds, time scales, relativistic time, and a powerful date & duration parser
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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157

#![cfg_attr(not(feature = "std"), no_std)]

#[cfg(feature = "alloc")]
extern crate alloc;
#[cfg(feature = "std")]
extern crate std;

// ──────────────────────────────────────────────────────────────
// Optional panic handler (opt-in via feature)
// ──────────────────────────────────────────────────────────────
#[cfg(all(feature = "panic-handler", not(feature = "std"), not(test)))]
use core::panic::PanicInfo;

#[cfg(all(feature = "panic-handler", not(feature = "std"), not(test)))]
#[panic_handler]
fn panic(_info: &PanicInfo) -> ! {
    // Uses spin_loop() for better power characteristics than plain loop{}
    loop {
        core::hint::spin_loop();
    }
}

// possibly upgrade to f128 when it's stable
pub type Real = f64;

#[macro_export]
macro_rules! f {
    ($x:expr) => {
        $x as $crate::Real
    };
}

#[inline(always)]
pub const fn to_sec_f(attos: u128) -> Real {
    f!(attos) / ATTOS_PER_SECF
}

/// Converts attoseconds → seconds (s)
#[inline(always)]
pub fn to_sec(attos: i128) -> i128 {
    attos / ATTOS_PER_SEC_I128
}

/// Converts attoseconds → milliseconds (ms)
#[inline(always)]
pub fn to_ms(attos: i128) -> i128 {
    attos / ATTOS_PER_MS_I128
}

/// Converts attoseconds → microseconds (us)
#[inline(always)]
pub fn to_us(attos: i128) -> i128 {
    attos / ATTOS_PER_US_I128
}

/// Converts attoseconds → nanoseconds (ns)
#[inline(always)]
pub fn to_ns(attos: i128) -> i128 {
    attos / ATTOS_PER_NS_I128
}

/// Converts attoseconds → picoseconds (ps)
#[inline(always)]
pub fn to_ps(attos: i128) -> i128 {
    attos / ATTOS_PER_PS_I128
}

/// Converts attoseconds → femtoseconds (fs)
#[inline(always)]
pub fn to_fs(attos: i128) -> i128 {
    attos / ATTOS_PER_FS_I128
}

// _________________________________________
// FEATURE MOD
// _________________________________________
#[cfg(feature = "parse")]
mod alloc_parse;

#[cfg(feature = "sidereal")]
mod sidereal;

// _________________________________________
// MOD
// _________________________________________
mod an_err;
mod ascii_str;
mod clock_model;
mod drift;
mod dt;
mod gregorian_time;
mod light_time;
mod parser;
mod position;
mod scale;
mod time_parts;
mod time_range;

// _________________________________________
// PUB MOD
// _________________________________________
pub mod constants;
pub mod error;
pub mod historical_sofa;
pub mod leap_seconds;
pub mod tzdb;
pub mod utils;

// _________________________________________
// FEATURE PUB MOD
// _________________________________________
#[cfg(feature = "bop")]
pub mod bop;

// _________________________________________
// FEATURE CRATE USE
// _________________________________________
#[cfg(feature = "parse")]
pub(crate) use alloc_parse::{
    alloc_constants::*, date::*, date_classification::*, duration::*, lang_data::*, lang_map::*,
    languages::en::*, parse_date::*, types::*,
};

// _________________________________________
// CRATE USE
// _________________________________________
pub(crate) use constants::*;
pub(crate) use utils::*;

// _________________________________________
// FEATURE PUB USE
// _________________________________________
#[cfg(feature = "parse")]
pub use alloc_parse::types::{DateOrder, DateParseMode, Lang, ParseCfg};

#[cfg(feature = "wire")]
pub use an_err::{WireErr, WireLocation};

#[cfg(feature = "sidereal")]
pub use sidereal::Sidereal;

// _________________________________________
// PUB USE
// _________________________________________
pub use an_err::AnErr;
pub use ascii_str::{AsciiStr, AsciiStrError};
pub use clock_model::ClockModel;
pub use drift::{Drift, Spacetime};
pub use dt::Dt;
pub use dt::numbers_traits::{AttosTraits, TimeTraits};
pub use error::{DtErr, DtErrKind};
pub use gregorian_time::{GregorianTime, YmdHms};
pub use light_time::ObserverState;
pub use position::{Position, Velocity};
pub use scale::Scale;
pub use time_parts::{Meridiem, Offset, TimeParts, Weekday};
pub use time_range::{Every, TimeRange};