Enum MonthName 

pub enum MonthName {
    January,
    February,
    March,
    April,
    May,
    June,
    July,
    August,
    September,
    October,
    November,
    December,
}

The name of a calendar month, as extracted from natural language input.

Conversions

MonthName can be constructed from either a string or a number:

use partial_date::models::{MonthName, MonthNameError};
use std::convert::TryFrom;

// From a name string (full, abbreviated, or unambiguous prefix)
assert_eq!(MonthName::try_from("October"), Ok(MonthName::October));
assert_eq!(MonthName::try_from("oct"),     Ok(MonthName::October));
assert_eq!(MonthName::try_from("Octo"),    Ok(MonthName::October));

// From a numeric string
assert_eq!(MonthName::try_from("10"), Ok(MonthName::October));

// From a u8
assert_eq!(MonthName::try_from(10_u8), Ok(MonthName::October));

// Errors
assert_eq!(MonthName::try_from(0_u8),  Err(MonthNameError::NumberOutOfRange(0)));
assert_eq!(MonthName::try_from(13_u8), Err(MonthNameError::NumberOutOfRange(13)));
assert_eq!(MonthName::try_from("Xyz"), Err(MonthNameError::UnrecognisedName));
assert_eq!(MonthName::try_from("5x"),  Err(MonthNameError::NotAMonth));

Variants

January

February

March

April

May

June

July

August

September

October

November

December

Implementations

impl MonthName

pub fn number(self) -> u8

Return the calendar number of this month (1 = January … 12 = December).

use partial_date::models::MonthName;
assert_eq!(MonthName::January.number(), 1);
assert_eq!(MonthName::December.number(), 12);

Trait Implementations

impl Clone for MonthName

fn clone(&self) -> MonthName

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MonthName

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

Formats the value using the given formatter.

impl PartialEq for MonthName

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

Convert a string into a MonthName.

Three strategies are tried in order:

1. Alphabetic match — if every character is ASCII alphabetic (after stripping a trailing .), the lowercased string is compared against all full names, standard 3-letter abbreviations, and unambiguous longer prefixes.

2. Fuzzy match — if no exact or prefix match was found, the Levenshtein ratio is computed against every full month name. The closest match is accepted when its ratio is ≥ 0.6 and it is unambiguously the best candidate (no tie). Returns MonthNameError::UnrecognisedName when no candidate passes.

3. Numeric match — if every character is an ASCII digit, the value is parsed as a u8 and forwarded to TryFrom<u8>. Returns MonthNameError::NumberOutOfRange when the number is outside 1–12.

If the string is neither purely alphabetic nor purely numeric (e.g. "jan2" or "5x"), MonthNameError::NotAMonth is returned.

type Error = MonthNameError

The type returned in the event of a conversion error.

fn try_from(s: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<u8> for MonthName

Convert a month number (1 = January … 12 = December) into a MonthName.

Returns MonthNameError::NumberOutOfRange for any value outside 1–12.

type Error = MonthNameError

The type returned in the event of a conversion error.

fn try_from(n: u8) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for MonthName

impl Eq for MonthName

impl StructuralPartialEq for MonthName