Skip to main content

satellite_datetime/
julian.rs

1//! Two-part Julian dates and day counts.
2
3use crate::constants::{NS_PER_DAY, TAI_EPOCH_JD, TAI_EPOCH_MJD};
4use crate::instant::Instant;
5
6/// Split a Julian Date into (day, fraction of day from midnight).
7#[derive(Clone, Copy, Debug, PartialEq)]
8pub struct JulianDate {
9    /// Integer + 0.5 style first part (SOFA: typically the whole JD at 0h or a large part).
10    pub d1: f64,
11    /// Remainder so that `d1 + d2` is the Julian Date.
12    pub d2: f64,
13}
14
15impl JulianDate {
16    /// Sum as `f64` (≈50 µs ULP near J2000).
17    pub fn as_f64(self) -> f64 {
18        self.d1 + self.d2
19    }
20
21    /// Modified Julian Date (`JD − 2400000.5`).
22    pub fn mjd(self) -> f64 {
23        self.as_f64() - 2_400_000.5
24    }
25}
26
27impl Instant {
28    /// Julian Date on TAI, two-part (large integer day + fraction) for ERFA-style tests.
29    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    /// Julian Date on TT.
40    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    /// MJD(TAI) as integer day + nanoseconds of day.
51    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
59/// Proleptic Gregorian civil date to Unix day number (days since 1970-01-01).
60/// Howard Hinnant's public-domain algorithm.
61pub 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
75/// Inverse of [`unix_days_from_civil`].
76pub 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        // 2000-01-01 12:00:00 TT = JD 2451545.0
108        // TT = TAI + 32.184 s → 12:00:00 TT = 11:59:27.816 TAI
109        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}