Enum chrono::Month

[−] Show declaration

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

[−] Expand description

The month of the year.

This enum is just a convenience implementation. The month in dates created by DateLike objects does not return this enum.

It is possible to convert from a date to a month independently

use num_traits::FromPrimitive;
use chrono::prelude::*;
let date = Utc.ymd(2019, 10, 28).and_hms(9, 10, 11);
// `2019-10-28T09:10:11Z`
let month = Month::from_u32(date.month());
assert_eq!(month, Some(Month::October))

Or from a Month to an integer usable by dates

let month = Month::January;
let dt = Utc.ymd(2019, month.number_from_month(), 28).and_hms(9, 10, 11);
assert_eq!((dt.year(), dt.month(), dt.day()), (2019, 1, 28));

Allows mapping from and to month, from 1-January to 12-December. Can be Serialized/Deserialized with serde

Variants

January

[−] Expand description

January

February

[−] Expand description

February

March

[−] Expand description

March

April

[−] Expand description

April

May

[−] Expand description

May

June

[−] Expand description

June

July

[−] Expand description

July

August

[−] Expand description

August

September

[−] Expand description

September

October

[−] Expand description

October

November

[−] Expand description

November

December

[−] Expand description

December

Implementations

impl Month[−]

pub fn succ(&self) -> Month[−]

The next month.

m:	January	February	...	December
m.succ():	February	March	...	January

pub fn pred(&self) -> Month[−]

The previous month.

m:	January	February	...	December
m.succ():	December	January	...	November

pub fn number_from_month(&self) -> u32[−]

Returns a month-of-year number starting from January = 1.

m:	January	February	...	December
m.number_from_month():	1	2	...	12

pub fn name(&self) -> &'static str[−]

Get the name of the month

use chrono::Month;

assert_eq!(Month::January.name(), "January")

Trait Implementations

impl Clone for Month[+]

[+] Show hidden undocumented items

fn clone(&self) -> Month[−]

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)[−]

Performs copy-assignment from source.

impl Copy for Month

impl Debug for Month[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Month[+]

[+] Show hidden undocumented items

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, [−]

Deserialize this value from the given Serde deserializer.

impl Eq for Month

impl FromPrimitive for Month[+]

[+] Show hidden undocumented items

fn from_u64(n: u64) -> Option<Month>[−]

Returns an Option from a i64, assuming a 1-index, January = 1.

Month::from_i64(n: i64): | 1 | 2 | … | 12 —————————| –––––––––– | ——————— | … | —– ``: | Some(Month::January) | Some(Month::February) | … | Some(Month::December)

fn from_i64(n: i64) -> Option<Month>[−]

Converts an i64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u32(n: u32) -> Option<Month>[−]

Converts an u32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_isize(n: isize) -> Option<Self>[−]

Converts an isize to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_i8(n: i8) -> Option<Self>[−]

Converts an i8 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_i16(n: i16) -> Option<Self>[−]

Converts an i16 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_i32(n: i32) -> Option<Self>[−]

Converts an i32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_i128(n: i128) -> Option<Self>[−]

Converts an i128 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_usize(n: usize) -> Option<Self>[−]

Converts a usize to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_u8(n: u8) -> Option<Self>[−]

Converts an u8 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_u16(n: u16) -> Option<Self>[−]

Converts an u16 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_u128(n: u128) -> Option<Self>[−]

Converts an u128 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_f32(n: f32) -> Option<Self>[−]

Converts a f32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

pub fn from_f64(n: f64) -> Option<Self>[−]

Converts a f64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

impl FromStr for Month[+]

Parsing a str into a Month uses the format %W.

Example

use chrono::Month;

assert_eq!("January".parse::<Month>(), Ok(Month::January));
assert!("any day".parse::<Month>().is_err());

The parsing is case-insensitive.

assert_eq!("fEbruARy".parse::<Month>(), Ok(Month::February));

Only the shortest form (e.g. jan) and the longest form (e.g. january) is accepted.

assert!("septem".parse::<Month>().is_err());
assert!("Augustin".parse::<Month>().is_err());

[+] Show hidden undocumented items

type Err = ParseMonthError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>[−]

Parses a string s to return a value of this type.

impl Hash for Month[+]

[+] Show hidden undocumented items

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl PartialEq<Month> for Month[+]

[+] Show hidden undocumented items

fn eq(&self, other: &Month) -> bool[−]

This method tests for self and other values to be equal, and is used by ==.

[+] Expand attributes

#[must_use]pub fn ne(&self, other: &Rhs) -> bool[−]

This method tests for !=.

impl Serialize for Month[+]

[+] Show hidden undocumented items

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, [−]

Serialize this value into the given Serde serializer.

impl StructuralEq for Month

impl StructuralPartialEq for Month