satellite_datetime/
julian.rs1use crate::constants::{NS_PER_DAY, TAI_EPOCH_JD, TAI_EPOCH_MJD};
4use crate::instant::Instant;
5
6#[derive(Clone, Copy, Debug, PartialEq)]
8pub struct JulianDate {
9 pub d1: f64,
11 pub d2: f64,
13}
14
15impl JulianDate {
16 pub fn as_f64(self) -> f64 {
18 self.d1 + self.d2
19 }
20
21 pub fn mjd(self) -> f64 {
23 self.as_f64() - 2_400_000.5
24 }
25}
26
27impl Instant {
28 pub fn julian_tai(self) -> JulianDate {
30 let ns = self.as_tai_nanos();
31 let days = (ns / NS_PER_DAY) as f64;
32 let rem = (ns % NS_PER_DAY) as f64 / NS_PER_DAY as f64;
33 JulianDate {
34 d1: TAI_EPOCH_JD + days,
35 d2: rem,
36 }
37 }
38
39 pub fn julian_tt(self) -> JulianDate {
41 let ns = self.reading_tt().as_nanos();
42 let days = (ns / NS_PER_DAY) as f64;
43 let rem = (ns % NS_PER_DAY) as f64 / NS_PER_DAY as f64;
44 JulianDate {
45 d1: TAI_EPOCH_JD + days,
46 d2: rem,
47 }
48 }
49
50 pub fn mjd_tai_parts(self) -> (i64, i128) {
52 let ns = self.as_tai_nanos();
53 let day = TAI_EPOCH_MJD + (ns / NS_PER_DAY) as i64;
54 let rem = ns % NS_PER_DAY;
55 (day, rem)
56 }
57}
58
59pub const fn unix_days_from_civil(y: i32, m: u8, d: u8) -> i64 {
62 let y = if m <= 2 { y - 1 } else { y };
63 let era = if y >= 0 { y } else { y - 399 } / 400;
64 let yoe = (y - era * 400) as u32;
65 let mp = if m > 2 {
66 (m as u32) - 3
67 } else {
68 (m as u32) + 9
69 };
70 let doy = (153 * mp + 2) / 5 + d as u32 - 1;
71 let doe = yoe * 365 + yoe / 4 - yoe / 100 + doy;
72 era as i64 * 146_097 + doe as i64 - 719_468
73}
74
75pub const fn civil_from_unix_days(z: i64) -> (i32, u8, u8) {
77 let z = z + 719_468;
78 let era = if z >= 0 { z } else { z - 146_096 } / 146_097;
79 let doe = (z - era * 146_097) as u32;
80 let yoe = (doe - doe / 1460 + doe / 36_524 - doe / 146_096) / 365;
81 let y = (yoe as i32) + era as i32 * 400;
82 let doy = doe - (365 * yoe + yoe / 4 - yoe / 100);
83 let mp = (5 * doy + 2) / 153;
84 let d = doy - (153 * mp + 2) / 5 + 1;
85 let m = if mp < 10 { mp + 3 } else { mp - 9 };
86 let y = if m <= 2 { y + 1 } else { y };
87 (y, m as u8, d as u8)
88}
89
90#[cfg(test)]
91mod tests {
92 use super::*;
93
94 #[test]
95 fn unix_epoch_and_tai_epoch() {
96 assert_eq!(unix_days_from_civil(1970, 1, 1), 0);
97 assert_eq!(unix_days_from_civil(1958, 1, 1), crate::TAI_EPOCH_UNIX_DAYS);
98 assert_eq!(civil_from_unix_days(0), (1970, 1, 1));
99 assert_eq!(
100 civil_from_unix_days(crate::TAI_EPOCH_UNIX_DAYS),
101 (1958, 1, 1)
102 );
103 }
104
105 #[test]
106 fn j2000_tt_jd() {
107 let civil_ok = unix_days_from_civil(2000, 1, 1);
110 let tai_days = civil_ok - crate::TAI_EPOCH_UNIX_DAYS;
111 let noon_minus = 12 * 3600 * crate::NS_PER_SEC - 32_184_000_000;
112 let inst = Instant::from_tai_nanos(tai_days as i128 * NS_PER_DAY + noon_minus);
113 let jd = inst.julian_tt().as_f64();
114 assert!((jd - 2_451_545.0).abs() < 1e-8, "jd={jd}");
115 }
116}