Struct InstantUtc

#[repr(C)]
pub struct InstantUtc {
    pub timestamp_utc: i64,
}

A timestamp denoting an instant on the UTC timeline.

Fields

timestamp_utc: i64

timestamp_utc is the number of nanoseconds since the start of the Unix epoch, relative to the UTC timezone.

Fuchsia FIDL library zx does not have a core type that denotes this (in contrast to say zx.Time), so we use a custom type to try and make it harder to provide a timestamp set on the wrong timeline.

Usage note

Timestamps that reference the UTC timeline are unusual. This is because the UTC timeline is actively adjusted to match the external notion of accurate UTC time, and can change the rate, or can even “jump” both forwards or backwards. Adjusting the notion of the UTC time manually can pull in or push out deadlines tied to this timeline.

This is why it is always recommended to use the UTC timeline only to denote instants on the UTC timeline, and not use it to measure durations.

Trait Implementations

impl Clone for InstantUtc

fn clone(&self) -> InstantUtc

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InstantUtc

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

Formats the value using the given formatter.

impl<D> Decode<InstantUtc, D> for InstantUtc

where D: ResourceDialect,

fn new_empty() -> InstantUtc

Creates a valid instance of Self. The specific value does not matter, since it will be overwritten by decode.

unsafe fn decode( &mut self, decoder: &mut Decoder<'_, D>, offset: usize, _depth: Depth, ) -> Result<(), Error>

Decodes an object of type T from the decoder’s buffers into self.

impl<D> Encode<InstantUtc, D> for &InstantUtc

where D: ResourceDialect,

unsafe fn encode( self, encoder: &mut Encoder<'_, D>, offset: usize, _depth: Depth, ) -> Result<(), Error>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID.

impl Hash for InstantUtc

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

where __H: Hasher,

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 Ord for InstantUtc

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for InstantUtc

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

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

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl TypeMarker for InstantUtc

type Owned = InstantUtc

The owned Rust type which this FIDL type decodes into.

fn inline_align(_context: Context) -> usize

Returns the minimum required alignment of the inline portion of the encoded object. It must be a (nonzero) power of two.

fn inline_size(_context: Context) -> usize

Returns the size of the inline portion of the encoded object, including padding for alignment. Must be a multiple of inline_align.

fn encode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and encoding requires no validation. When true, we can optimize encoding arrays and vectors of Self::Owned to a single memcpy.

fn decode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and decoding requires no validation. When true, we can optimize decoding arrays and vectors of Self::Owned to a single memcpy.

impl ValueTypeMarker for InstantUtc

type Borrowed<'a> = &'a InstantUtc

The Rust type to use for encoding. This is a particular Encode<Self> type cheaply obtainable from &Self::Owned. There are three cases:

fn borrow( value: &<InstantUtc as TypeMarker>::Owned, ) -> <InstantUtc as ValueTypeMarker>::Borrowed<'_>

Cheaply converts from &Self::Owned to Self::Borrowed.

impl Copy for InstantUtc

impl Eq for InstantUtc

impl Persistable for InstantUtc

impl StructuralPartialEq for InstantUtc