Enum time::format_description::FormatItem
source · #[non_exhaustive]
pub enum FormatItem<'a> {
Literal(&'a [u8]),
Component(Component),
Compound(&'a [Self]),
Optional(&'a Self),
First(&'a [Self]),
}Available on crate features
formatting or parsing only.Expand description
A complete description of how to format and parse a type.
Variants (Non-exhaustive)§
This enum is marked as 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.
Literal(&'a [u8])
Bytes that are formatted as-is.
Note: If you call the format method that returns a String, these bytes will be
passed through String::from_utf8_lossy.
Component(Component)
A minimal representation of a single non-literal item.
Compound(&'a [Self])
A series of literals or components that collectively form a partial or complete description.
Optional(&'a Self)
A FormatItem that may or may not be present when parsing. If parsing fails, there
will be no effect on the resulting struct.
This variant has no effect on formatting, as the value is guaranteed to be present.
First(&'a [Self])
A series of FormatItems where, when parsing, the first successful parse is used. When
formatting, the first element of the slice is used. An empty slice is a no-op when
formatting or parsing.
Trait Implementations§
source§impl<'a> Clone for BorrowedFormatItem<'a>
impl<'a> Clone for BorrowedFormatItem<'a>
source§impl Debug for BorrowedFormatItem<'_>
Available on crate feature alloc only.
impl Debug for BorrowedFormatItem<'_>
Available on crate feature
alloc only.source§impl<'a> From<&'a [BorrowedFormatItem<'_>]> for BorrowedFormatItem<'a>
impl<'a> From<&'a [BorrowedFormatItem<'_>]> for BorrowedFormatItem<'a>
source§fn from(items: &'a [BorrowedFormatItem<'_>]) -> Self
fn from(items: &'a [BorrowedFormatItem<'_>]) -> Self
Converts to this type from the input type.
source§impl From<&BorrowedFormatItem<'_>> for OwnedFormatItem
Available on crate feature alloc only.
impl From<&BorrowedFormatItem<'_>> for OwnedFormatItem
Available on crate feature
alloc only.source§fn from(item: &FormatItem<'_>) -> Self
fn from(item: &FormatItem<'_>) -> Self
Converts to this type from the input type.
source§impl From<BorrowedFormatItem<'_>> for OwnedFormatItem
Available on crate feature alloc only.
impl From<BorrowedFormatItem<'_>> for OwnedFormatItem
Available on crate feature
alloc only.source§fn from(item: FormatItem<'_>) -> Self
fn from(item: FormatItem<'_>) -> Self
Converts to this type from the input type.
source§impl From<Component> for BorrowedFormatItem<'_>
impl From<Component> for BorrowedFormatItem<'_>
source§impl PartialEq<&[BorrowedFormatItem<'_>]> for BorrowedFormatItem<'_>
impl PartialEq<&[BorrowedFormatItem<'_>]> for BorrowedFormatItem<'_>
source§impl PartialEq<BorrowedFormatItem<'_>> for &[BorrowedFormatItem<'_>]
impl PartialEq<BorrowedFormatItem<'_>> for &[BorrowedFormatItem<'_>]
source§fn eq(&self, rhs: &BorrowedFormatItem<'_>) -> bool
fn eq(&self, rhs: &BorrowedFormatItem<'_>) -> bool
This method tests for
self and other values to be equal, and is used
by ==.source§impl PartialEq<BorrowedFormatItem<'_>> for Component
impl PartialEq<BorrowedFormatItem<'_>> for Component
source§fn eq(&self, rhs: &BorrowedFormatItem<'_>) -> bool
fn eq(&self, rhs: &BorrowedFormatItem<'_>) -> bool
This method tests for
self and other values to be equal, and is used
by ==.source§impl<'a> PartialEq<BorrowedFormatItem<'a>> for BorrowedFormatItem<'a>
impl<'a> PartialEq<BorrowedFormatItem<'a>> for BorrowedFormatItem<'a>
source§fn eq(&self, other: &BorrowedFormatItem<'a>) -> bool
fn eq(&self, other: &BorrowedFormatItem<'a>) -> bool
This method tests for
self and other values to be equal, and is used
by ==.source§impl PartialEq<Component> for BorrowedFormatItem<'_>
impl PartialEq<Component> for BorrowedFormatItem<'_>
source§impl TryFrom<BorrowedFormatItem<'_>> for Component
impl TryFrom<BorrowedFormatItem<'_>> for Component
§type Error = DifferentVariant
type Error = DifferentVariant
The type returned in the event of a conversion error.
source§impl<'a> TryFrom<BorrowedFormatItem<'a>> for &[BorrowedFormatItem<'a>]
impl<'a> TryFrom<BorrowedFormatItem<'a>> for &[BorrowedFormatItem<'a>]
§type Error = DifferentVariant
type Error = DifferentVariant
The type returned in the event of a conversion error.
impl<'a> Eq for BorrowedFormatItem<'a>
impl Formattable for FormatItem<'_>
Available on crate feature
formatting only.impl Parsable for FormatItem<'_>
Available on crate feature
parsing only.