deep-time 0.1.0-alpha.2

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

use crate::{Dt, clamp_i128_to_i64};
use chrono::{DateTime, Utc};

impl Dt {
    /// Converts this `Dt` to a `chrono::DateTime<chrono::Utc>`.
    ///
    /// This is the main/default conversion method for absolute instants.
    ///
    /// - The `Dt` is first converted to TAI internally (respecting all
    ///   scales, leap seconds, and relativistic models).
    /// - The duration since the Unix epoch (1970-01-01 00:00:00 UTC) is then
    ///   computed.
    /// - Sub-nanosecond attoseconds are truncated toward zero.
    /// - Saturates at the minimum/maximum representable `DateTime<Utc>`
    ///   (roughly years 1678–2262) if the instant is out of range.
    ///   Never returns an error.
    pub fn to_chrono_datetime_utc(self) -> DateTime<Utc> {
        let span_since_epoch = self.to_tai_since(Dt::UNIX_EPOCH);
        let total_nanos = span_since_epoch.to_attos() / 1_000_000_000i128;
        let nanos = clamp_i128_to_i64(total_nanos);

        DateTime::<Utc>::from_timestamp_nanos(nanos)
    }
}