Struct Year

#[non_exhaustive]
pub struct Year {
    pub padding: Padding,
    pub repr: YearRepr,
    pub range: YearRange,
    pub iso_week_based: bool,
    pub sign_is_mandatory: bool,
}

Available on crate features formatting or parsing only.

Year of the date.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

padding: Padding

The padding to obtain the minimum width.

repr: YearRepr

What kind of representation should be used?

range: YearRange

What range of years is supported?

iso_week_based: bool

Whether the value is based on the ISO week number or the Gregorian calendar.

sign_is_mandatory: bool

Whether the + sign is present when a positive year contains fewer than five digits.

Implementations

impl Year

pub const fn default() -> Self

Creates a modifier that indicates the value uses the Full representation, is padded with zeroes, uses the Gregorian calendar as its base, and only includes the year’s sign if necessary.

This function exists since Default::default() cannot be used in a const context. It may be removed once that becomes possible. As the Default trait is in the prelude, removing this function in the future will not cause any resolution failures for the overwhelming majority of users; only users who use #![no_implicit_prelude] will be affected. As such it will not be considered a breaking change.

Trait Implementations

impl Clone for Year

fn clone(&self) -> Year

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Year

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

Formats the value using the given formatter.

impl Default for Year

Creates a modifier that indicates the value uses the Full representation, is padded with zeroes, uses the Gregorian calendar as its base, and only includes the year’s sign if necessary.

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Year

#[doc(hidden)] fn assert_receiver_is_total_eq(&self)

impl PartialEq for Year

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

impl StructuralPartialEq for Year