deep-time 0.1.0-alpha.1

High-precision time types, time scale conversions, relativistic time, and a flexible date and 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

use crate::TSpan;
use hifitime::{Duration, Epoch, TimeScale};

impl TSpan {
    /// Converts this `TSpan` to a [`hifitime::Duration`] (nanosecond precision).
    ///
    /// - Sub-nanosecond attoseconds are **truncated toward zero**.
    /// - The conversion is fully exact up to the nanosecond (128-bit integer arithmetic).
    /// - Internally uses [`hifitime::Duration::from_total_nanoseconds`], which
    ///   automatically normalizes centuries/nanoseconds and saturates at
    ///   [`Duration::MAX`] / [`Duration::MIN`] if outside hifitime's range
    ///   (±32,768 centuries).
    #[inline]
    pub fn to_hifitime_duration(self) -> Duration {
        Duration::from_total_nanoseconds(self.to_attos() / 1_000_000_000i128)
    }

    /// Converts this `TSpan` to a [`hifitime::Epoch`] using the given `TimeScale`.
    ///
    /// The `TSpan` is interpreted as the **offset from the reference epoch**
    /// of the supplied `time_scale` (TAI reference for `TimeScale::TAI`,
    /// J2000 for `TT`/`TDB`/`ET`, GPS epoch for `GPS`, Unix for `UTC`, etc.).
    ///
    /// Uses the generic `hifitime::Epoch::from_duration` constructor — the most
    /// direct and flexible way to respect any attached epoch/timescale.
    #[inline]
    pub fn to_hifitime_epoch(self, time_scale: TimeScale) -> Epoch {
        Epoch::from_duration(self.to_hifitime_duration(), time_scale)
    }
}