Struct Utc 

pub struct Utc;

UTC — Coordinated Universal Time

• UTC = TAI − LS(t)
• Requires a runtime leap-second table
• Format: "UTC +Ss Nns"

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 Hash for Utc

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoScale<Utc> for Time<Glonass>

fn into_scale(self) -> Result<Time<Utc>, GnssTimeError>

GLONASS -> UTC: fixed epoch shift.

GLONASS uses UTC(SU), a time scale offset from UTC by +3 hours and including leap seconds.

use gnss_time::{DurationParts, Glonass, IntoScale, Time, Utc};

let glo = Time::<Glonass>::from_day_tod(
    0,
    DurationParts {
        seconds: 0,
        nanos: 0,
    },
)
.unwrap(); // GLONASS epoch
let utc: Time<Utc> = glo.into_scale().unwrap();

// UTC at the GLONASS epoch:
// 1995-12-31 21:00:00 UTC = 757_371_600 s from 1972
assert_eq!(utc.as_nanos(), 757_371_600_000_000_000);

impl IntoScaleWith<Utc> for Time<Beidou>

fn into_scale_with<P: LeapSecondsProvider>( self, ls: P, ) -> Result<Time<Utc>, GnssTimeError>

BeiDou -> UTC via GPS.

fn into_scale_with_checked<P: LeapSecondsProvider>( self, ls: P, ) -> Result<ConvertResult<Time<Utc>>, GnssTimeError>

Converts and reports whether the result is ambiguous due to a leap-second insertion.

impl IntoScaleWith<Utc> for Time<Galileo>

fn into_scale_with<P: LeapSecondsProvider>( self, ls: P, ) -> Result<Time<Utc>, GnssTimeError>

Galileo -> UTC via GPS (both share the same TAI offset of 19s).

fn into_scale_with_checked<P: LeapSecondsProvider>( self, ls: P, ) -> Result<ConvertResult<Time<Utc>>, GnssTimeError>

Converts and reports whether the result is ambiguous due to a leap-second insertion.

impl IntoScaleWith<Utc> for Time<Gps>

fn into_scale_with<P: LeapSecondsProvider>( self, ls: P, ) -> Result<Time<Utc>, GnssTimeError>

GPS -> UTC with leap-second context.

Round-trip consistency: GPS -> UTC -> GPS is exact (< 1 ns) for all moments except the one-second leap-second insertion window.

use gnss_time::{Gps, IntoScaleWith, LeapSeconds, Time, Utc};

let ls = LeapSeconds::builtin();
let gps = Time::<Gps>::from_seconds(1_167_264_018); // 2017-01-01 GPS
let utc: Time<Utc> = gps.into_scale_with(ls).unwrap();

let delta = gps.as_seconds() as i64 - utc.as_seconds() as i64 + 252_892_800_i64;

// GPS leads UTC by 18 s → UTC is 18 s earlier
assert_eq!(delta, 18);

fn into_scale_with_checked<P: LeapSecondsProvider>( self, ls: P, ) -> Result<ConvertResult<Time<Utc>>, GnssTimeError>

Converts and reports whether the result is ambiguous due to a leap-second insertion.

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 TimeScale for Utc

const NAME: &'static str = "UTC"

Short identifier used in formatting.

const OFFSET_TO_TAI: OffsetToTai = OffsetToTai::Contextual

Offset relative to TAI:

const EPOCH_CIVIL: CivilDate

Civil epoch of the scale (where time == 0).

const DISPLAY_STYLE: DisplayStyle = DisplayStyle::Simple

Formatting style for display output.

impl Copy for Utc

impl Eq for Utc

impl StructuralPartialEq for Utc