Enum Component

#[non_exhaustive]
pub enum Component {
    Day(Day),
    Month(Month),
    Ordinal(Ordinal),
    Weekday(Weekday),
    WeekNumber(WeekNumber),
    Year(Year),
    Hour(Hour),
    Minute(Minute),
    Period(Period),
    Second(Second),
    Subsecond(Subsecond),
    OffsetHour(OffsetHour),
    OffsetMinute(OffsetMinute),
    OffsetSecond(OffsetSecond),
    Ignore(Ignore),
    UnixTimestamp(UnixTimestamp),
    End(End),
}

Available on crate features formatting or parsing only.

A component of a larger format description.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Day(Day)

Day of the month.

Month(Month)

Month of the year.

Ordinal(Ordinal)

Ordinal day of the year.

Weekday(Weekday)

Day of the week.

WeekNumber(WeekNumber)

Week within the year.

Year(Year)

Year of the date.

Hour(Hour)

Hour of the day.

Minute(Minute)

Minute within the hour.

Period(Period)

AM/PM part of the time.

Second(Second)

Second within the minute.

Subsecond(Subsecond)

Subsecond within the second.

OffsetHour(OffsetHour)

Hour of the UTC offset.

OffsetMinute(OffsetMinute)

Minute within the hour of the UTC offset.

OffsetSecond(OffsetSecond)

Second within the minute of the UTC offset.

Ignore(Ignore)

A number of bytes to ignore when parsing. This has no effect on formatting.

UnixTimestamp(UnixTimestamp)

A Unix timestamp.

End(End)

The end of input. Parsing this component will fail if there is any input remaining. This component neither affects formatting nor consumes any input when parsing.

Trait Implementations

impl Clone for Component

fn clone(&self) -> Component

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Component

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

Formats the value using the given formatter.

impl From<Component> for BorrowedFormatItem<'_>

fn from(component: Component) -> Self

Converts to this type from the input type.

impl From<Component> for OwnedFormatItem

Available on crate feature alloc only.

fn from(component: Component) -> Self

Converts to this type from the input type.

impl PartialEq<BorrowedFormatItem<'_>> for Component

fn eq(&self, rhs: &BorrowedFormatItem<'_>) -> 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 PartialEq<Component> for BorrowedFormatItem<'_>

fn eq(&self, rhs: &Component) -> 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 PartialEq<Component> for OwnedFormatItem

Available on crate feature alloc only.

fn eq(&self, rhs: &Component) -> 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 PartialEq<OwnedFormatItem> for Component

Available on crate feature alloc only.

fn eq(&self, rhs: &OwnedFormatItem) -> 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 PartialEq for Component

fn eq(&self, other: &Component) -> 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 TryFrom<BorrowedFormatItem<'_>> for Component

type Error = DifferentVariant

The type returned in the event of a conversion error.

fn try_from(value: BorrowedFormatItem<'_>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedFormatItem> for Component

Available on crate feature alloc only.

type Error = DifferentVariant

The type returned in the event of a conversion error.

fn try_from(value: OwnedFormatItem) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Component

impl Eq for Component

impl StructuralPartialEq for Component

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 4 bytes

Size for each variant:

• Day: 2 bytes
• Month: 4 bytes
• Ordinal: 2 bytes
• Weekday: 4 bytes
• WeekNumber: 3 bytes
• Year: 4 bytes
• Hour: 3 bytes
• Minute: 2 bytes
• Period: 3 bytes
• Second: 2 bytes
• Subsecond: 2 bytes
• OffsetHour: 3 bytes
• OffsetMinute: 2 bytes
• OffsetSecond: 2 bytes
• Ignore: 4 bytes
• UnixTimestamp: 3 bytes
• End: 0 bytes