Struct googapis::google::actions::type::DateRange

pub struct DateRange {
    pub start: Option<Date>,
    pub end: Option<Date>,
}

Represents a range based on whole or partial calendar dates, e.g. the duration of a hotel reservation or the Common Era. This can represent:

• A range between full dates, e.g. the duration of a hotel reservation
• A range between years, e.g. a historical era
• A range between year/month dates, e.g. the duration of a job on a resume
• A range beginning in a year, e.g. the Common Era
• A range ending on a specific date, e.g. the period of time before an event

While [google.type.Date][google.type.Date] allows zero years, DateRange does not. Year must always be non-zero.

End cannot be chronologically before start. For example, if start has year 2000, end cannot have year 1999.

When both set, start and end must have exactly the same precision. That is, they must have the same fields populated with non-zero values. For example, if start specifies only year and month, then end must also specify only year and month (but not day).

The date range is inclusive. That is, the dates specified by start and end are part of the date range. For example, the date January 1, 2000 falls within any date with start or end equal to January 1, 2000. When determining whether a date is inside a date range, the date should only be compared to start and end when those values are set.

When a date and date range are specified to different degrees of precision, the rules for evaluating whether that date is inside the date range are as follows:

• When comparing the date to the start of the date range, unspecified months should be replaced with 1, and unspecified days should be replaced with 1. For example, the year 2000 is within the date range with start equal to January 1, 2000 and no end. And the date January 1, 2000 is within the date range with start equal to the year 2000 and no end.

• When comparing the date to the end of the date range, unspecified months should be replaced with 12, and unspecified days should be replaced with the last valid day for the month/year. For example, the year 2000 is within the date range with start equal to January 1, 1999 and end equal to December 31, 2000. And the date December 31, 2001 is within the date range with start equal to the year 2000 and end equal to the year 2001.

The semantics of start and end are the same as those of [google.type.Date][google.type.Date], except that year must always be non-zero in DateRange.

Fields

start: Option<Date>

Date at which the date range begins. If unset, the date range has no beginning bound.

end: Option<Date>

Date at which the date range ends. If unset, the date range has no ending bound.

Trait Implementations

impl Clone for DateRange

fn clone(&self) -> DateRange

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DateRange

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

Formats the value using the given formatter.

impl Default for DateRange

fn default() -> Self

Returns the “default value” for a type.

impl Message for DateRange

fn encode_raw<B>(&self, buf: &mut B) where
    B: BufMut, 

fn merge_field<B>(
    &mut self,
    tag: u32,
    wire_type: WireType,
    buf: &mut B,
    ctx: DecodeContext
) -> Result<(), DecodeError> where
    B: Buf, 

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode<B>(&self, buf: &mut B) -> Result<(), EncodeError> where
    B: BufMut, 

Encodes the message to a buffer.

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

Encodes the message to a newly allocated buffer.

fn encode_length_delimited<B>(&self, buf: &mut B) -> Result<(), EncodeError> where
    B: BufMut, 

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8, Global>

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode<B>(buf: B) -> Result<Self, DecodeError> where
    Self: Default,
    B: Buf, 

Decodes an instance of the message from a buffer.

fn decode_length_delimited<B>(buf: B) -> Result<Self, DecodeError> where
    Self: Default,
    B: Buf, 

Decodes a length-delimited instance of the message from the buffer.

fn merge<B>(&mut self, buf: B) -> Result<(), DecodeError> where
    B: Buf, 

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited<B>(&mut self, buf: B) -> Result<(), DecodeError> where
    B: Buf, 

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq<DateRange> for DateRange

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

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &DateRange) -> bool

This method tests for !=.

impl StructuralPartialEq for DateRange