Struct UTC 

pub struct UTC(/* private fields */);

UTC time scale backed by a split Julian Date.

Wraps JulianDate to represent Coordinated Universal Time. Supports construction from Unix timestamps, calendar components, or raw Julian Dates.

Implementations

impl UTC

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

Creates UTC from Unix timestamp (seconds and nanoseconds since 1970-01-01 00:00:00).

Days are computed separately from sub-day time to preserve precision. The resulting Julian Date uses jd1 for whole days and jd2 for the fractional part.

pub fn from_julian_date(jd: JulianDate) -> Self

Creates UTC from a Julian Date.

pub fn j2000() -> Self

Returns UTC at the J2000.0 epoch (2000-01-01 12:00:00 TT, JD 2451545.0).

pub fn to_julian_date(&self) -> JulianDate

Returns the underlying Julian Date.

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

Returns a new UTC offset by the given seconds.

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

Returns a new UTC offset by the given days.

pub fn now() -> Self

Returns the current UTC time from the system clock.

pub fn to_iso8601(&self) -> String

Formats as ISO 8601 string (YYYY-MM-DDTHH:MM:SS.sss).

Falls back to “JD{value}” if calendar conversion fails.

Trait Implementations

impl Clone for UTC

fn clone(&self) -> UTC

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UTC

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

Formats the value using the given formatter.

impl Display for UTC

Displays as “UTC {julian_date}”.

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

Formats the value using the given formatter.

impl From<JulianDate> for UTC

Converts JulianDate to UTC.

fn from(jd: JulianDate) -> Self

Converts to this type from the input type.

impl FromStr for UTC

Parses ISO 8601 formatted strings into UTC.

type Err = TimeError

The associated error which can be returned from parsing.

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

Parses a string s to return a value of this type.

impl PartialEq for UTC

fn eq(&self, other: &UTC) -> 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 ToTAI for UTC

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

Convert UTC to TAI by adding the accumulated leap seconds.

Looks up the TAI-UTC offset for the given date and applies drift corrections for pre-1972 dates. Handles leap second boundaries correctly.

impl ToUT1WithDUT1 for UTC

fn to_ut1_with_dut1(&self, dut1_seconds: f64) -> TimeResult<UT1>

Convert UTC to UT1 by computing UT1-TAI from DUT1 and TAI-UTC.

The conversion uses the relationship:

UT1 - TAI = DUT1 - (TAI - UTC) = DUT1 - TAI_UTC_offset

The TAI-UTC offset is looked up from the leap second table for the specific date. The result chains: UTC → TAI → UT1.

impl ToUTC for UTC

fn to_utc(&self) -> TimeResult<UTC>

Identity conversion. Returns self unchanged.

impl Copy for UTC

impl StructuralPartialEq for UTC