Skip to main content

Year

Struct Year 

Source
#[non_exhaustive]
pub struct Year { pub padding: Padding, pub repr: YearRepr, pub range: YearRange, pub iso_week_based: bool, pub sign_is_mandatory: bool, }
๐Ÿ‘ŽDeprecated since 0.3.48: use one of the various Year* components instead
Available on crate features formatting or parsing only.
Expand description

Year of the date.

Fields (Non-exhaustive)ยง

This struct is marked as 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
๐Ÿ‘ŽDeprecated since 0.3.48: use one of the various Year* components instead

The padding to obtain the minimum width.

ยงrepr: YearRepr
๐Ÿ‘ŽDeprecated since 0.3.48: use one of the various Year* components instead

What kind of representation should be used?

ยงrange: YearRange
๐Ÿ‘ŽDeprecated since 0.3.48: use one of the various Year* components instead

What range of years is supported?

ยงiso_week_based: bool
๐Ÿ‘ŽDeprecated since 0.3.48: use one of the various Year* components instead

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

ยงsign_is_mandatory: bool
๐Ÿ‘ŽDeprecated since 0.3.48: use one of the various Year* components instead

Whether the + sign is present when a non-negative year contains fewer digits than necessary.

Implementationsยง

Sourceยง

impl Year

Source

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.

Sourceยง

impl Year

Source

pub const fn with_padding(self, padding: Padding) -> Self

Set the padding type.

Source

pub const fn with_repr(self, repr: YearRepr) -> Self

Set the manner in which the year is represented.

Source

pub const fn with_range(self, range: YearRange) -> Self

Set the range of years that are supported.

Source

pub const fn with_iso_week_based(self, iso_week_based: bool) -> Self

Set whether the year is based on the ISO week number.

Source

pub const fn with_sign_is_mandatory(self, sign_is_mandatory: bool) -> Self

Set whether the + sign is mandatory for positive years with fewer than five digits.

Trait Implementationsยง

Sourceยง

impl Clone for Year

Sourceยง

fn clone(&self) -> Year

Returns a duplicate of the value. Read more
1.0.0 ยท Sourceยง

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

Performs copy-assignment from source. Read more
Sourceยง

impl Debug for Year

Sourceยง

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

Formats the value using the given formatter. Read more
Sourceยง

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.

Sourceยง

fn default() -> Self

Returns the โ€œdefault valueโ€ for a type. Read more
Sourceยง

impl Eq for Year

Sourceยง

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

๐Ÿ”ฌThis is a nightly-only experimental API. (derive_eq_internals)
1.0.0 ยท Sourceยง

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

๐Ÿ‘ŽDeprecated since 1.95.0: implementation detail of #[derive(Eq)]
Sourceยง

impl PartialEq for Year

Sourceยง

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 ยท Sourceยง

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Sourceยง

impl Copy for Year

Sourceยง

impl StructuralPartialEq for Year

Sourceยง

impl TrivialClone for Year

Auto Trait Implementationsยง

Blanket Implementationsยง

Sourceยง

impl<T> Any for T
where T: 'static + ?Sized,

Sourceยง

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Sourceยง

impl<T> Borrow<T> for T
where T: ?Sized,

Sourceยง

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Sourceยง

impl<T> BorrowMut<T> for T
where T: ?Sized,

Sourceยง

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Sourceยง

impl<T> CloneToUninit for T
where T: Clone,

Sourceยง

unsafe fn clone_to_uninit(&self, dest: *mut u8)

๐Ÿ”ฌThis is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Sourceยง

impl<T> From<T> for T

Sourceยง

fn from(t: T) -> T

Returns the argument unchanged.

Sourceยง

impl<T, U> Into<U> for T
where U: From<T>,

Sourceยง

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Sourceยง

impl<T> SizedTypeProperties for T

Sourceยง

#[doc(hidden)]
const SIZE: usize = _

๐Ÿ”ฌThis is a nightly-only experimental API. (sized_type_properties)
Sourceยง

#[doc(hidden)]
const ALIGN: usize = _

๐Ÿ”ฌThis is a nightly-only experimental API. (sized_type_properties)
Sourceยง

#[doc(hidden)]
const ALIGNMENT: Alignment = _

๐Ÿ”ฌThis is a nightly-only experimental API. (ptr_alignment_type)
Sourceยง

#[doc(hidden)]
const IS_ZST: bool = _

๐Ÿ”ฌThis is a nightly-only experimental API. (sized_type_properties)
true if this type requires no storage. false if its size is greater than zero. Read more
Sourceยง

#[doc(hidden)]
const LAYOUT: Layout = _

๐Ÿ”ฌThis is a nightly-only experimental API. (sized_type_properties)
Sourceยง

#[doc(hidden)]
const MAX_SLICE_LEN: usize = _

๐Ÿ”ฌThis is a nightly-only experimental API. (sized_type_properties)
The largest safe length for a [Self]. Read more
Sourceยง

impl<T> ToOwned for T
where T: Clone,

Sourceยง

type Owned = T

The resulting type after obtaining ownership.
Sourceยง

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Sourceยง

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Sourceยง

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Sourceยง

type Error = Infallible

The type returned in the event of a conversion error.
Sourceยง

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Sourceยง

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Sourceยง

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Sourceยง

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Sourceยง

impl<T> Printable for T
where T: Copy + Debug,