Skip to main content

TT

Struct TT 

Source
pub struct TT(/* private fields */);
Expand description

Terrestrial Time representation.

Wraps a split Julian Date for high-precision time storage. TT is the primary time scale for geocentric ephemeris calculations.

Implementations§

Source§

impl TT

Source

pub fn new(seconds: i64, nanos: u32) -> Self

Creates TT from Unix timestamp components.

Converts seconds and nanoseconds since Unix epoch (1970-01-01T00:00:00) to TT Julian Date representation.

Source

pub fn from_julian_date(jd: JulianDate) -> Self

Creates TT from a split Julian Date.

Source

pub fn from_julian_date_raw(jd1: f64, jd2: f64) -> Self

Creates TT from raw Julian Date components.

Use when you have separate jd1/jd2 values and want to avoid intermediate JulianDate construction.

Source

pub fn j2000() -> Self

Returns TT at J2000.0 epoch (2000-01-01T12:00:00 TT).

This is the fundamental epoch for modern astronomical calculations. JD = 2451545.0.

Source

pub fn to_julian_date(&self) -> JulianDate

Returns the underlying Julian Date.

Source

pub fn add_seconds(&self, seconds: f64) -> Self

Returns a new TT offset by the given number of seconds.

Source

pub fn add_days(&self, days: f64) -> Self

Returns a new TT offset by the given number of days.

Source

pub fn from_jd(jd: f64) -> TimeResult<Self>

Creates TT from a single-value Julian Date.

For high-precision work, prefer from_julian_date with split values.

Source

pub fn julian_year(&self) -> f64

Returns the Julian year corresponding to this TT instant.

Julian year = 2000.0 + (JD - J2000_JD) / 365.25

Source

pub fn centuries_since_j2000(&self) -> f64

Returns Julian centuries since J2000.0 (the T parameter).

This is the time argument used in IAU precession and nutation series. One Julian century = 36525 days.

Trait Implementations§

Source§

impl Clone for TT

Source§

fn clone(&self) -> TT

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for TT

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for TT

Formats as “TT {julian_date}”.

Source§

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

Formats the value using the given formatter. Read more
Source§

impl From<JulianDate> for TT

Converts JulianDate to TT directly.

Source§

fn from(jd: JulianDate) -> Self

Converts to this type from the input type.
Source§

impl FromStr for TT

Parses TT from ISO 8601 format (e.g., “2000-01-01T12:00:00”).

Assumes the input string represents a TT instant directly.

Source§

type Err = TimeError

The associated error which can be returned from parsing.
Source§

fn from_str(s: &str) -> TimeResult<Self>

Parses a string s to return a value of this type. Read more
Source§

impl NutationCalculator for TT

Source§

impl PartialEq for TT

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl PrecessionCalculator for TT

Source§

impl ToTAI for TT

Convert TT to TAI by subtracting the fixed 32.184 second offset.

The offset is subtracted from whichever Julian Date component has smaller magnitude to preserve maximum precision in the two-part representation.

Source§

fn to_tai(&self) -> TimeResult<TAI>

Convert to TAI.
Source§

impl ToTCG for TT

Source§

fn to_tcg(&self) -> TimeResult<TCG>

Convert TT to TCG by applying the L_G rate correction.

Uses L_G / (1 - L_G) as the rate ratio for the forward transformation. This ratio accounts for the fact that we’re computing TCG from TT, not vice versa.

At J2000.0, this adds about 0.506 seconds.

Source§

impl ToTDB for TT

Source§

fn to_tdb_greenwich(&self) -> TimeResult<TDB>

Convert to TDB using Greenwich Observatory as reference.
Source§

fn to_tdb_with_location(&self, location: &Location) -> TimeResult<TDB>

Convert to TDB using the specified observer location.
Source§

fn to_tdb_with_location_and_ut1_offset( &self, location: &Location, ut1_offset_seconds: f64, ) -> TimeResult<TDB>

Convert to TDB with location and UT1-UTC offset for maximum precision.
Source§

fn to_tdb_with_offset(&self, dtr_seconds: f64) -> TimeResult<TDB>

Convert to TDB using a pre-computed offset (TDB-TT) in seconds.
Source§

impl ToTT for TT

Identity conversion for TT.

Source§

fn to_tt(&self) -> TimeResult<TT>

Convert to Terrestrial Time.
Source§

impl ToUT1WithDeltaT for TT

Source§

fn to_ut1_with_delta_t(&self, delta_t_seconds: f64) -> TimeResult<UT1>

Convert to UT1 using the given Delta-T in seconds. Read more
Source§

impl Copy for TT

Source§

impl StructuralPartialEq for TT

Auto Trait Implementations§

§

impl Freeze for TT

§

impl RefUnwindSafe for TT

§

impl Send for TT

§

impl Sync for TT

§

impl Unpin for TT

§

impl UnsafeUnpin for TT

§

impl UnwindSafe for TT

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.