Skip to main content

UTC

Struct UTC 

Source
pub struct UTC;
Expand description

Coordinated Universal Time.

Leap-second-aware civil scale. Time<UTC> stores a continuous instant; leap-second interpretation is computed on demand from the UTC-TAI segment table. Raw-axis arithmetic acts on that stored instant.

§Storage invariant

Time<UTC> and Time<TAI> store the same continuous instant for the same physical event. Scale conversion between them is therefore a numeric no-op at the storage layer.

UTC participates in CoordinateScale, so Time<UTC> exposes the same raw J2000/JD/MJD instant-axis helpers and second-based arithmetic as the other built-in scales. Those operations act on the stored continuous instant, not on a leap-second-labelled civil clock.

UTC still does not implement ContinuousScale. Generic code that wants a scale with no civil semantics should keep using that stricter bound; generic code that merely needs a raw coordinate axis can use CoordinateScale.

§Authoritative UTC API

Use the civil layer for any operation that depends on the UTC-TAI offset (i.e., leap seconds):

Trait Implementations§

Source§

impl Clone for UTC

Source§

fn clone(&self) -> UTC

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl ContextConversionTarget<UTC> for Unix

Source§

impl ConversionTarget<UT1> for UTC

Source§

impl ConversionTarget<UTC> for UT1

Source§

impl Debug for UTC

Source§

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

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

impl Hash for UTC

Source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

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

Feeds a slice of this type into the given Hasher. Read more
Source§

impl Ord for UTC

Source§

fn cmp(&self, other: &UTC) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 (const: unstable) · Source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 (const: unstable) · Source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 (const: unstable) · Source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

Restrict a value to a certain interval. Read more
Source§

impl PartialEq for UTC

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · 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 PartialOrd for UTC

Source§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 (const: unstable) · Source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 (const: unstable) · Source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 (const: unstable) · Source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 (const: unstable) · Source§

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

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

impl RepresentationForScale<UTC> for Unix

Source§

impl Scale for UTC

Source§

const NAME: &'static str = "UTC"

Display name of the scale. Used by Debug on Time.
Source§

impl CoordinateScale for UTC

Source§

impl Copy for UTC

Source§

impl Eq for UTC

Source§

impl StructuralPartialEq for UTC

Auto Trait Implementations§

§

impl Freeze for UTC

§

impl RefUnwindSafe for UTC

§

impl Send for UTC

§

impl Sync for UTC

§

impl Unpin for UTC

§

impl UnsafeUnpin for UTC

§

impl UnwindSafe for UTC

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<S1, S2> ContextConversionTarget<S1> for S2
where S1: Scale + ContextScaleConvert<S2>, S2: Scale,

Source§

impl<S1, S2> ConversionTarget<S1> for S2
where S1: Scale + InfallibleScaleConvert<S2>, S2: Scale,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<S1, S2> InfallibleConversionTarget<S1> for S2
where S1: Scale + InfallibleScaleConvert<S2>, S2: Scale,

Source§

fn convert(src: Time<S1>) -> <S2 as ConversionTarget<S1>>::Output

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> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

Source§

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more
Source§

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).
Source§

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.
Source§

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.
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, 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.
Source§

impl<T> Scalar for T
where T: 'static + Clone + PartialEq + Debug,