Struct Date 

pub struct Date {
    pub year: Option<i16>,
    pub month: Option<i8>,
    pub day: Option<i8>,
}

Represents a whole or partial calendar date, such as a birthday.

The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:

• A full date, with non-zero year, month, and day values.
• A month and day, with a zero year (for example, an anniversary).
• A year on its own, with a zero month and a zero day.
• A year and month, with a zero day (for example, a credit card expiration date).

Related types:

• google.type.TimeOfDay
• google.type.DateTime
• google.protobuf.Timestamp

Fields

year: Option<i16>

Year of the date.

Must be from 1 to 9_999, or 0 to specify a date without a year.

month: Option<i8>

Month of a year.

Must be from 1 to 12, or 0 to specify a year without a month and day.

day: Option<i8>

Day of a month.

Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn’t significant.

Implementations

impl Date

pub fn year(&self) -> Option<i16>

Year of the date.

Must be from 1 to 9_999, or 0 to specify a date without a year.

pub fn month(&self) -> Option<i8>

Month of a year.

Must be from 1 to 12, or 0 to specify a year without a month and day.

pub fn day(&self) -> Option<i8>

Day of a month.

Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn’t significant.

impl Date

pub const fn has_year(&self) -> bool

Returns whether this date has a year component.

pub const fn has_month(&self) -> bool

Returns whether this date has a month component.

pub const fn has_day(&self) -> bool

Returns whether this date has a day component.

pub const fn is_complete(&self) -> bool

Returns whether this is a complete date (has year, month, and day).

pub const fn is_empty(&self) -> bool

Returns whether this date is completely empty (no components specified).

pub fn try_to_jiff_date(&self) -> Result<Option<JiffDate>, Error>

Attempts to convert this Date to a jiff::civil::Date.

Returns a Date if this Date has complete year, month, and day information and represents a valid calendar date. Returns None for incomplete dates.

Errors

Returns an error if the date components form an invalid date (e.g., February 30th).

pub fn to_jiff_date(&self) -> Option<JiffDate>

Gets a jiff::civil::Date if this is a complete and valid date.

This is a convenience method that returns None if the conversion fails rather than returning an error.

pub fn from_jiff_date(jiff_date: &JiffDate) -> Self

Creates a Date from a jiff::civil::Date.

Trait Implementations

impl Clone for Date

fn clone(&self) -> Date

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Date

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

Formats the value using the given formatter.

impl Default for Date

fn default() -> Date

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Date

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Date> for Date

fn from(jiff_date: &JiffDate) -> Self

Converts a jiff::civil::Date to Google Maps Places (new) Date.

impl Hash for Date

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 Date

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&Date> for Option<Date>

fn try_from(date: &Date) -> Result<Self, Self::Error>

Converts a Google Maps Places (new) Date to an Option<jiff::civil::Date>.

Requires the Date to have complete year, month, and day components that form a valid calendar date or this will return None.

Errors

Returns an error if the components form an invalid date.

type Error = Error

The type returned in the event of a conversion error.

impl Copy for Date

impl Eq for Date

impl StructuralPartialEq for Date