Struct Utc 

pub struct Utc;

Time scale representing Coordinated Universal Time (UTC). This scale is adjusted using leap seconds to closely match the rotation of the Earth. This makes it useful as civil time scale, but also means that external, discontinuous synchronization is required.

The synchronization based on leap seconds is implemented to occur at the date-time boundary. This means that it is only done when a UTC time point is created based on a date-time pair, after which it is converted into a time-since-epoch representation. This makes arithmetic over UTC time points much more efficient and entirely correct over all possible leap second boundaries.

This choice does also mean that introduction of new leap seconds does not “shift” any UTC time stamps that were created to be after the point of introduction of this leap second. Generally, this is desired behaviour, but in human communication it might not be. In such cases, users are better off storing their UTC timestamps as date-time pairs and only converting them into UtcTime at the point of use.

Trait Implementations

impl AbsoluteTimeScale for Utc

const EPOCH: Date

This epoch is the exact date at which the modern definition of UTC started. This makes it useful, because users may choose to permit “proleptic” UTC dates before 1972 by using a signed representation, but may also choose to forbid it by using unsigned arithmetic, which leads to easy-to-detect underflows whenever an ambiguous pre-1972 UTC date-time is created.

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

const TAI_OFFSET: Duration = Duration::ZERO

Perhaps confusingly, we define UTC as coinciding with TAI. This is entirely possible because we handle leap seconds at the date-time boundary: after converting UTC into its time-since-epoch variation, there are no leap seconds to speak of anymore.

impl TimeScale for Utc

const NAME: &'static str = "Coordinated Universal Time"

The full (English) name of a time scale.

const ABBREVIATION: &'static str = "UTC"

The abbreviated string used to represent this time scale.

impl Copy for Utc

impl Eq for Utc

impl StructuralPartialEq for Utc