deep-time 0.1.0-beta.21

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

use crate::{DtErr, Parts};
use alloc::string::String;

impl Parts {
    /// Returns this instant as a **CCSDS ASCII Time Code** (calendar variant A).
    ///
    /// Example: `"2025-04-17T14:30:45.123456789Z"`
    ///
    /// - Uses `T` separator and trailing `Z`.
    /// - Fractional seconds are trimmed (no trailing zeros, no dot if zero).
    /// - Round-trips with `Dt::from_str_iso` / `Parts::from_str_iso`.
    #[inline]
    pub fn to_str_ccsds(&self) -> Result<String, DtErr> {
        self.to_dt()?.to_str_ccsds()
    }

    /// Same as
    /// [`Parts::to_str_ccsds`](../struct.Parts.html#method.to_str_ccsds)
    /// but lets you control the maximum number of fractional digits (0–18).
    pub fn to_str_ccsds_nf(&self, max_precision: usize) -> Result<String, DtErr> {
        self.to_dt()?.to_str_ccsds_nf(max_precision)
    }

    /// Returns this instant as a **CCSDS ASCII Time Code B** (day-of-year variant).
    ///
    /// Example: `"2025-107T14:30:45.123456789Z"`
    #[inline]
    pub fn to_ccsds_doy_str(&self) -> Result<String, DtErr> {
        self.to_dt()?.to_ccsds_doy_str_nf(18)
    }

    /// Same as
    /// [`Parts::to_ccsds_doy_str`](../struct.Parts.html#method.to_ccsds_doy_str)
    /// but with configurable fractional precision.
    pub fn to_ccsds_doy_str_nf(&self, max_precision: usize) -> Result<String, DtErr> {
        self.to_dt()?.to_ccsds_doy_str_nf(max_precision)
    }
}