Struct Duration 

pub struct Duration {
    pub seconds: i64,
    pub nanos: i32,
    /* private fields */
}

Fields

seconds: i64

Field 1: seconds

nanos: i32

Field 2: nanos

Implementations

impl Duration

pub fn from_secs(seconds: i64) -> Self

Create a Duration from a whole number of seconds.

pub fn from_secs_nanos(seconds: i64, nanos: i32) -> Self

Create a Duration from seconds and nanoseconds.

Panics

Panics in debug mode if nanos is outside [-999_999_999, 999_999_999] or if its sign is inconsistent with seconds. When seconds is zero, nanos may be positive, negative, or zero. In release mode the value is stored as-is. Use Duration::from_secs_nanos_checked for a variant that returns None on invalid input.

pub fn from_secs_nanos_checked(seconds: i64, nanos: i32) -> Option<Self>

Create a Duration from seconds and nanoseconds, returning None if nanos is out of range or has a sign inconsistent with seconds.

pub fn from_millis(millis: i64) -> Self

Create a Duration from a number of milliseconds.

The sign of millis determines the sign of both seconds and the sub-second nanos field, per the protobuf sign-consistency rule.

pub fn from_micros(micros: i64) -> Self

Create a Duration from a number of microseconds.

pub fn from_nanos(nanos: i64) -> Self

Create a Duration from a number of nanoseconds.

impl Duration

pub const TYPE_URL: &'static str = "type.googleapis.com/google.protobuf.Duration"

Protobuf type URL for this message, for use with Any::pack and Any::unpack_if.

Format: type.googleapis.com/<fully.qualified.TypeName>

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for Duration

fn arbitrary(u: &mut Unstructured<'arbitrary>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'arbitrary>) -> Result<Self>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for Duration

fn clone(&self) -> Duration

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Duration

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

Formats the value using the given formatter.

impl Default for Duration

fn default() -> Duration

Returns the “default value” for a type.

impl DefaultInstance for Duration

fn default_instance() -> &'static Self

Return a reference to the single default instance of this type.

impl<'de> Deserialize<'de> for Duration

Available on crate feature json only.

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserializes from a decimal seconds string (e.g. "1.5s").

impl From<Duration> for Duration

Available on crate feature std only.

fn from(d: Duration) -> Self

Convert a std::time::Duration to a protobuf Duration.

Saturation

Durations whose as_secs() exceeds i64::MAX (~292 billion years) are saturated to i64::MAX seconds rather than wrapping, which would produce an incorrect negative value.

impl Message for Duration

fn compute_size(&self) -> u32

Returns the total encoded size in bytes.

The result is a u32; the protobuf specification requires all messages to fit within 2 GiB (2,147,483,647 bytes), so a compliant message will never overflow this type.

fn write_to(&self, buf: &mut impl BufMut)

Write this message’s encoded bytes to a buffer.

fn merge_field( &mut self, tag: Tag, buf: &mut impl Buf, depth: u32, ) -> Result<(), DecodeError>

Processes a single already-decoded tag and its associated field data from buf.

fn cached_size(&self) -> u32

The cached encoded size from the last compute_size() call.

fn clear(&mut self)

Clear all fields to their default values.

fn encode(&self, buf: &mut impl BufMut)

Convenience: compute size, then write. This is the primary encoding API.

fn encode_length_delimited(&self, buf: &mut impl BufMut)

Encode this message as a length-delimited byte sequence.

fn encode_to_vec(&self) -> Vec<u8>

Encode this message to a new Vec<u8>.

fn encode_to_bytes(&self) -> Bytes

Encode this message to a new bytes::Bytes.

fn decode(buf: &mut impl Buf) -> Result<Self, DecodeError>

where Self: Sized,

Decode a message from a buffer.

fn decode_from_slice(data: &[u8]) -> Result<Self, DecodeError>

where Self: Sized,

Decode a message from a byte slice.

fn decode_length_delimited(buf: &mut impl Buf) -> Result<Self, DecodeError>

where Self: Sized,

Decode a length-delimited message from a buffer.

fn merge_to_limit( &mut self, buf: &mut impl Buf, depth: u32, limit: usize, ) -> Result<(), DecodeError>

Merge fields from a buffer until buf.remaining() reaches limit.

fn merge_group( &mut self, buf: &mut impl Buf, depth: u32, field_number: u32, ) -> Result<(), DecodeError>

Merges a group-encoded message from buf, reading fields until an EndGroup tag with the given field_number is encountered.

fn merge(&mut self, buf: &mut impl Buf, depth: u32) -> Result<(), DecodeError>

Merge fields from a buffer into this message.

fn merge_from_slice(&mut self, data: &[u8]) -> Result<(), DecodeError>

Merge fields from a byte slice into this message.

fn merge_length_delimited( &mut self, buf: &mut impl Buf, depth: u32, ) -> Result<(), DecodeError>

Merge fields from a length-delimited sub-message payload into this message.

impl PartialEq for Duration

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

Available on crate feature json only.

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serializes as a decimal seconds string (e.g. "1.5s", "-0.001s").

Errors

Returns a serialization error if the duration is outside the proto spec range of ±315,576,000,000 seconds, or if nanos is invalid.

impl TryFrom<Duration> for Duration

Available on crate feature std only.

fn try_from(d: Duration) -> Result<Self, Self::Error>

Convert a protobuf Duration to a std::time::Duration.

Errors

Returns DurationError::InvalidNanos if nanos is outside [-999_999_999, 999_999_999] or if its sign is inconsistent with seconds (e.g. positive nanos with negative seconds).

Returns DurationError::NegativeDuration if the duration is negative but otherwise well-formed (e.g. seconds < 0, nanos ≤ 0), since std::time::Duration cannot represent negative values.

type Error = DurationError

The type returned in the event of a conversion error.

impl StructuralPartialEq for Duration