pub enum Weekday {
Mon,
Tue,
Wed,
Thu,
Fri,
Sat,
Sun,
}
Expand description
The day of week.
The order of the days of week depends on the context.
(This is why this type does not implement PartialOrd
or Ord
traits.)
One should prefer *_from_monday
or *_from_sunday
methods to get the correct result.
Example
use chrono::Weekday;
let monday = "Monday".parse::<Weekday>().unwrap();
assert_eq!(monday, Weekday::Mon);
let sunday = Weekday::try_from(6).unwrap();
assert_eq!(sunday, Weekday::Sun);
assert_eq!(sunday.num_days_from_monday(), 6); // starts counting with Monday = 0
assert_eq!(sunday.number_from_monday(), 7); // starts counting with Monday = 1
assert_eq!(sunday.num_days_from_sunday(), 0); // starts counting with Sunday = 0
assert_eq!(sunday.number_from_sunday(), 1); // starts counting with Sunday = 1
assert_eq!(sunday.succ(), monday);
assert_eq!(sunday.pred(), Weekday::Sat);
Variants
Mon
Monday.
Tue
Tuesday.
Wed
Wednesday.
Thu
Thursday.
Fri
Friday.
Sat
Saturday.
Sun
Sunday.
Implementations
sourceimpl Weekday
impl Weekday
sourcepub const fn succ(&self) -> Weekday
pub const fn succ(&self) -> Weekday
The next day in the week.
w : | Mon | Tue | Wed | Thu | Fri | Sat | Sun |
---|---|---|---|---|---|---|---|
w.succ() : | Tue | Wed | Thu | Fri | Sat | Sun | Mon |
sourcepub const fn pred(&self) -> Weekday
pub const fn pred(&self) -> Weekday
The previous day in the week.
w : | Mon | Tue | Wed | Thu | Fri | Sat | Sun |
---|---|---|---|---|---|---|---|
w.pred() : | Sun | Mon | Tue | Wed | Thu | Fri | Sat |
sourcepub const fn number_from_monday(&self) -> u32
pub const fn number_from_monday(&self) -> u32
Returns a day-of-week number starting from Monday = 1. (ISO 8601 weekday number)
w : | Mon | Tue | Wed | Thu | Fri | Sat | Sun |
---|---|---|---|---|---|---|---|
w.number_from_monday() : | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
sourcepub const fn number_from_sunday(&self) -> u32
pub const fn number_from_sunday(&self) -> u32
Returns a day-of-week number starting from Sunday = 1.
w : | Mon | Tue | Wed | Thu | Fri | Sat | Sun |
---|---|---|---|---|---|---|---|
w.number_from_sunday() : | 2 | 3 | 4 | 5 | 6 | 7 | 1 |
sourcepub const fn num_days_from_monday(&self) -> u32
pub const fn num_days_from_monday(&self) -> u32
Returns a day-of-week number starting from Monday = 0.
w : | Mon | Tue | Wed | Thu | Fri | Sat | Sun |
---|---|---|---|---|---|---|---|
w.num_days_from_monday() : | 0 | 1 | 2 | 3 | 4 | 5 | 6 |
sourcepub const fn num_days_from_sunday(&self) -> u32
pub const fn num_days_from_sunday(&self) -> u32
Returns a day-of-week number starting from Sunday = 0.
w : | Mon | Tue | Wed | Thu | Fri | Sat | Sun |
---|---|---|---|---|---|---|---|
w.num_days_from_sunday() : | 1 | 2 | 3 | 4 | 5 | 6 | 0 |
Trait Implementations
sourceimpl FromPrimitive for Weekday
impl FromPrimitive for Weekday
Any weekday can be represented as an integer from 0 to 6, which equals to
Weekday::num_days_from_monday
in this implementation.
Do not heavily depend on this though; use explicit methods whenever possible.
sourcefn from_i64(n: i64) -> Option<Weekday>
fn from_i64(n: i64) -> Option<Weekday>
i64
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_u64(n: u64) -> Option<Weekday>
fn from_u64(n: u64) -> Option<Weekday>
u64
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_isize(n: isize) -> Option<Self>
fn from_isize(n: isize) -> Option<Self>
isize
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_i8(n: i8) -> Option<Self>
fn from_i8(n: i8) -> Option<Self>
i8
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_i16(n: i16) -> Option<Self>
fn from_i16(n: i16) -> Option<Self>
i16
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_i32(n: i32) -> Option<Self>
fn from_i32(n: i32) -> Option<Self>
i32
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_i128(n: i128) -> Option<Self>
fn from_i128(n: i128) -> Option<Self>
i128
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_usize(n: usize) -> Option<Self>
fn from_usize(n: usize) -> Option<Self>
usize
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_u8(n: u8) -> Option<Self>
fn from_u8(n: u8) -> Option<Self>
u8
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_u16(n: u16) -> Option<Self>
fn from_u16(n: u16) -> Option<Self>
u16
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_u32(n: u32) -> Option<Self>
fn from_u32(n: u32) -> Option<Self>
u32
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourcefn from_u128(n: u128) -> Option<Self>
fn from_u128(n: u128) -> Option<Self>
u128
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresourceimpl FromStr for Weekday
impl FromStr for Weekday
Parsing a str
into a Weekday
uses the format %W
.
Example
use chrono::Weekday;
assert_eq!("Sunday".parse::<Weekday>(), Ok(Weekday::Sun));
assert!("any day".parse::<Weekday>().is_err());
The parsing is case-insensitive.
assert_eq!("mON".parse::<Weekday>(), Ok(Weekday::Mon));
Only the shortest form (e.g. sun
) and the longest form (e.g. sunday
) is accepted.
assert!("thurs".parse::<Weekday>().is_err());
sourceimpl TryFrom<u8> for Weekday
impl TryFrom<u8> for Weekday
Any weekday can be represented as an integer from 0 to 6, which equals to
Weekday::num_days_from_monday
in this implementation.
Do not heavily depend on this though; use explicit methods whenever possible.