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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
use crate::{Dt, DtErr, TimeParts};
impl TimeParts {
/// Formats this [`TimeParts`] as a **CCSDS C (CUC)** binary time code.
///
/// Fully configurable for round-tripping with [`from_ccsds_c`].
/// Conforms to **CCSDS 301.0-B-4 §3.2 (Level 1)**, including full support for the
/// extended P-field (second octet) when `n_coarse > 4` or `n_frac > 3`.
///
/// # Parameters
/// - `n_coarse`: 1–7 (number of coarse-time octets)
/// - `n_frac`: 0–10 (number of fractional octets)
/// - `extension`: advisory flag (ignored when larger sizes force the second octet)
#[inline]
pub fn to_ccsds_c(
&self,
n_coarse: u8,
n_frac: u8,
extension: bool,
) -> Result<([u8; Dt::CCSDS_C_AND_D_MAX_SIZE], usize), DtErr> {
self.to_time_point()?
.to_ccsds_c(n_coarse, n_frac, extension)
}
/// Formats this [`TimeParts`] as a **CCSDS D (CDS)** binary time code.
///
/// Fully configurable for round-tripping with [`from_ccsds_d`].
/// Conforms to CCSDS 301.0-B-4 §3.3 (Level 1): UTC day count + ms-of-day since 1958-01-01 UTC.
#[inline]
pub fn to_ccsds_d(
&self,
n_day: u8,
sub_ms_code: u8,
extension: bool,
) -> Result<([u8; Dt::CCSDS_C_AND_D_MAX_SIZE], usize), DtErr> {
self.to_time_point()?
.to_ccsds_d(n_day, sub_ms_code, extension)
}
/// Formats this [`TimeParts`] as a **CCSDS CCS (Calendar Segmented Time Code)**.
///
/// Implements **CCSDS 301.0-B-4 §3.4** (Level 1 only).
///
/// # Parameters
/// - `use_doy`: `false` = Month/Day variant (most common), `true` = Day-of-Year variant
/// - `n_subsec`: Number of subsecond BCD octets (`0`–`6`). Each octet holds 2 decimal digits.
///
/// # Returns
/// `(buffer, written_len)` — the P-field + T-field (big-endian BCD).
///
/// # Precision & Rounding
/// Fractional seconds are rounded to the nearest representable value at the chosen precision
/// (exactly as `to_ccsds_d` does for milliseconds).
#[inline]
pub fn to_ccsds_ccs(
&self,
use_doy: bool,
n_subsec: u8,
) -> Result<([u8; Dt::CCSDS_CCS_MAX_SIZE], usize), DtErr> {
self.to_time_point()?.to_ccsds_ccs(use_doy, n_subsec)
}
/// Convenience method that automatically selects the most appropriate
/// CCSDS binary time code based on this `TimeParts`’s [`Scale`].
///
/// # Automatic selection (matches common mission practice)
/// - `Scale::TAI` → **CUC** (4 coarse + 4 fractional bytes)
/// - Any other `Scale` (UTC, TT, GPS, TCG, …) → converted to UTC and uses **CDS**
/// (2 day bytes + 4 ms bytes + 2-byte sub-ms)
#[inline]
pub fn to_ccsds_bin(&self) -> Result<([u8; Dt::CCSDS_C_AND_D_MAX_SIZE], usize), DtErr> {
self.to_time_point()?.to_ccsds_bin(self.scale)
}
}