Enum Numeric

#[non_exhaustive]
pub enum Numeric {
    Year,
    YearDiv100,
    YearMod100,
    IsoYear,
    IsoYearDiv100,
    IsoYearMod100,
    Month,
    Day,
    WeekFromSun,
    WeekFromMon,
    IsoWeek,
    NumDaysFromSun,
    WeekdayFromMon,
    Ordinal,
    Hour,
    Hour12,
    Minute,
    Second,
    Nanosecond,
    Timestamp,
    Internal(InternalNumeric),
}

Numeric item types. They have associated formatting width (FW) and parsing width (PW).

The formatting width is the minimal width to be formatted. If the number is too short, and the padding is not Pad::None, then it is left-padded. If the number is too long or (in some cases) negative, it is printed as is.

The parsing width is the maximal width to be scanned. The parser only tries to consume from one to given number of digits (greedily). It also trims the preceding whitespace if any. It cannot parse the negative number, so some date and time cannot be formatted then parsed with the same formatting items.

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.

Year

Full Gregorian year (FW=4, PW=∞). May accept years before 1 BCE or after 9999 CE, given an initial sign (+/-).

YearDiv100

Gregorian year divided by 100 (century number; FW=PW=2). Implies the non-negative year.

YearMod100

Gregorian year modulo 100 (FW=PW=2). Cannot be negative.

IsoYear

Year in the ISO week date (FW=4, PW=∞). May accept years before 1 BCE or after 9999 CE, given an initial sign.

IsoYearDiv100

Year in the ISO week date, divided by 100 (FW=PW=2). Implies the non-negative year.

IsoYearMod100

Year in the ISO week date, modulo 100 (FW=PW=2). Cannot be negative.

Month

Month (FW=PW=2).

Day

Day of the month (FW=PW=2).

WeekFromSun

Week number, where the week 1 starts at the first Sunday of January (FW=PW=2).

WeekFromMon

Week number, where the week 1 starts at the first Monday of January (FW=PW=2).

IsoWeek

Week number in the ISO week date (FW=PW=2).

NumDaysFromSun

Day of the week, where Sunday = 0 and Saturday = 6 (FW=PW=1).

WeekdayFromMon

Day of the week, where Monday = 1 and Sunday = 7 (FW=PW=1).

Ordinal

Day of the year (FW=PW=3).

Hour

Hour number in the 24-hour clocks (FW=PW=2).

Hour12

Hour number in the 12-hour clocks (FW=PW=2).

Minute

The number of minutes since the last whole hour (FW=PW=2).

Second

The number of seconds since the last whole minute (FW=PW=2).

Nanosecond

The number of nanoseconds since the last whole second (FW=PW=9). Note that this is not left-aligned; see also Fixed::Nanosecond.

Timestamp

The number of non-leap seconds since the midnight UTC on January 1, 1970 (FW=1, PW=∞). For formatting, it assumes UTC upon the absence of time zone offset.

Internal(InternalNumeric)

Internal uses only.

This item exists so that one can add additional internal-only formatting without breaking major compatibility (as enum variants cannot be selectively private).

Trait Implementations

impl Clone for Numeric

fn clone(&self) -> Numeric

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Numeric

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

Formats the value using the given formatter.

impl Hash for Numeric

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given [Hasher].

impl PartialEq for Numeric

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

impl StructuralPartialEq for Numeric