Struct EncodedTime 

pub struct EncodedTime<S: Scale, F: TimeFormat> { /* private fields */ }

A typed external encoding of a Time<S> instant.

EncodedTime<S, F> carries two phantom type parameters:

• S: Scale — the physical time axis (TT, TAI, UTC, …).
• F: TimeFormat — the encoding scheme (JD, MJD, J2000s, Unix, GPS).

The compiler therefore treats EncodedTime<TT, JD> and EncodedTime<UTC, JD> as completely distinct, incompatible types even though both carry a day-valued quantity internally.

Implementations

impl<S: Scale, F: TimeFormat> EncodedTime<S, F>

pub const fn from_raw_unchecked(raw: Quantity<F::Unit>) -> Self

Construct from a raw typed quantity without checking for finiteness.

For use in const contexts. The caller must ensure raw is finite; passing a non-finite value produces incorrect behaviour.

pub const fn raw(self) -> Quantity<F::Unit>

Return the underlying typed quantity.

pub const fn quantity(self) -> Quantity<F::Unit>

Alias for Self::raw.

impl<S: Scale> EncodedTime<S, JD>

pub const J2000: Self

J2000.0 epoch as a Julian Date on scale S (JD 2 451 545.0).

impl<S: Scale, F> EncodedTime<S, F>

where F: FormatForScale<S>,

pub fn try_new(raw: Quantity<F::Unit>) -> Result<Self, ConversionError>

Construct a typed encoded instant from its raw quantity.

pub fn try_to_time(self) -> Result<Time<S>, ConversionError>

Convert this encoded instant to the canonical Time<S> model.

Snapshots the active time-data bundle at call time via TimeContext::new. For reproducible pipelines, prefer to_time_with with an explicit context.

pub fn to_time_with(self, ctx: &TimeContext) -> Result<Time<S>, ConversionError>

Convert this encoded instant to the canonical Time<S> model using an explicit context.

impl<S: Scale, F> EncodedTime<S, F>

where F: InfallibleFormatForScale<S>,

pub fn to_time(self) -> Time<S>

Infallible conversion to the canonical Time<S> model.

pub fn to<T>(self) -> T::Output

where T: InfallibleConversionTarget<S>,

Unified infallible conversion to a target scale or encoded format.

pub fn try_to<T>(self) -> Result<T::Output, ConversionError>

where T: ConversionTarget<S>,

Unified fallible conversion to a target scale or encoded format.

impl<S: Scale, F> EncodedTime<S, F>

where F: FormatForScale<S>,

pub fn to_with<T>(self, ctx: &TimeContext) -> Result<T::Output, ConversionError>

where T: ContextConversionTarget<S>,

Unified context-backed conversion to a target scale or encoded format.

Trait Implementations

impl<S: Scale, F: TimeFormat> Clone for EncodedTime<S, F>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<S: Scale, F: TimeFormat> Debug for EncodedTime<S, F>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S: Scale, F: TimeFormat> Display for EncodedTime<S, F>

where Quantity<F::Unit>: Display,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S: Scale, F: TimeFormat> From<Coord<S, F>> for EncodedTime<S, F>

fn from(value: Coord<S, F>) -> Self

Converts to this type from the input type.

impl<S: Scale, F: TimeFormat> From<EncodedTime<S, F>> for Coord<S, F>

fn from(value: EncodedTime<S, F>) -> Self

Converts to this type from the input type.

impl<S: Scale, F> From<EncodedTime<S, F>> for Time<S>

where F: InfallibleFormatForScale<S>,

fn from(value: EncodedTime<S, F>) -> Self

Converts to this type from the input type.

impl<S: Scale, F> From<Time<S>> for EncodedTime<S, F>

where F: InfallibleFormatForScale<S>,

fn from(value: Time<S>) -> Self

Converts to this type from the input type.

impl<S: Scale, F: TimeFormat> LowerExp for EncodedTime<S, F>

where Quantity<F::Unit>: LowerExp,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S: Scale, F: TimeFormat> PartialEq for EncodedTime<S, F>

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<S: Scale, F: TimeFormat> PartialOrd for EncodedTime<S, F>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<S: Scale, F: TimeFormat> UpperExp for EncodedTime<S, F>

where Quantity<F::Unit>: UpperExp,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S: Scale, F: TimeFormat> Copy for EncodedTime<S, F>