Struct Iso8601

pub struct Iso8601<const CONFIG: EncodedConfig = { Config::DEFAULT.encode() }>;

Available on crate features formatting or parsing only.

The format described in ISO 8601.

This implementation is of ISO 8601-1:2019. It may not be compatible with other versions.

The const parameter CONFIG must be a value that was returned by Config::encode. Passing any other value is unspecified behavior.

Example: 1997-11-21T09:55:06.000000000-06:00

Examples

assert_eq!(
    datetime!(1997-11-12 9:55:06 -6:00).format(&Iso8601::DEFAULT)?,
    "1997-11-12T09:55:06.000000000-06:00"
);

Implementations

impl Iso8601<DEFAULT>

pub const DEFAULT: Self = Self

An Iso8601 with the default configuration.

The following is the default behavior:

• The configuration can be used for both formatting and parsing.
• The date, time, and UTC offset are all formatted.
• Separators (such as - and :) are included.
• The year contains four digits, such that the year must be between 0 and 9999.
• The date uses the calendar format.
• The time has precision to the second and nine decimal digits.
• The UTC offset has precision to the minute.

If you need different behavior, use another associated constant. For full customization, use Config::DEFAULT and Config’s methods to create a custom configuration.

impl Iso8601<PARSING>

pub const PARSING: Self = Self

An Iso8601 that can only be used for parsing. Using this to format a value is unspecified behavior.

impl Iso8601<DATE>

pub const DATE: Self = Self

An Iso8601 that handles only the date, but is otherwise the same as Config::DEFAULT.

impl Iso8601<TIME>

pub const TIME: Self = Self

An Iso8601 that handles only the time, but is otherwise the same as Config::DEFAULT.

impl Iso8601<OFFSET>

pub const OFFSET: Self = Self

An Iso8601 that handles only the UTC offset, but is otherwise the same as Config::DEFAULT.

impl Iso8601<DATE_TIME>

pub const DATE_TIME: Self = Self

An Iso8601 that handles the date and time, but is otherwise the same as Config::DEFAULT.

impl Iso8601<DATE_TIME_OFFSET>

pub const DATE_TIME_OFFSET: Self = Self

An Iso8601 that handles the date, time, and UTC offset. This is the same as Config::DEFAULT.

impl Iso8601<TIME_OFFSET>

pub const TIME_OFFSET: Self = Self

An Iso8601 that handles the time and UTC offset, but is otherwise the same as Config::DEFAULT.

Trait Implementations

impl<const CONFIG: EncodedConfig> Clone for Iso8601<CONFIG>

fn clone(&self) -> Iso8601<CONFIG>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<const CONFIG: EncodedConfig> Debug for Iso8601<CONFIG>

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

Formats the value using the given formatter.

impl<const CONFIG: EncodedConfig> PartialEq for Iso8601<CONFIG>

fn eq(&self, other: &Iso8601<CONFIG>) -> 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<const CONFIG: EncodedConfig> Copy for Iso8601<CONFIG>

impl<const CONFIG: EncodedConfig> Eq for Iso8601<CONFIG>

impl<const CONFIG: EncodedConfig> Formattable for Iso8601<CONFIG>

Available on crate feature formatting only.

impl<const CONFIG: EncodedConfig> Parsable for Iso8601<CONFIG>

Available on crate feature parsing only.

impl<const CONFIG: EncodedConfig> StructuralPartialEq for Iso8601<CONFIG>

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: 0 bytes