Struct Persian 

pub struct Persian;

The Persian Calendar

The Persian Calendar is a solar calendar used officially by the countries of Iran and Afghanistan and many Persian-speaking regions.

This implementation extends proleptically for dates before the calendar’s creation in 458 AP (1079 CE).

This corresponds to the "persian" CLDR calendar.

Era codes

This calendar uses a single era code ap, with Anno Persico/Anno Persarum starting the year of the Hijra. Dates before this era use negative years.

Months and days

The 12 months are called Farvardin (M01, 31 days), Ordibehesht (M02, 31 days), Khordad (M03, 31 days), Tir (M04, 31 days), Mordad (M05, 31 days), Shahrivar (M06, 31 days), Mehr (M07, 30 days), Aban (M08, 30 days), Azar (M09, 30 days), Dey (M10, 30 days), Bahman (M11, 30 days), Esfand (M12, 29 days).

In leap years (determined astronomically with respect to the vernal equinox), Esfand gains a 30th day.

Standard years thus have 365 days, and leap years 366.

Calendar drift

As leap years are determined with respect to the solar year, this calendar stays anchored to the seasons.

Implementations

impl Persian

pub fn new() -> Self

Constructs a new Persian Calendar

Trait Implementations

impl Calendar for Persian

type DateInner = PersianDateInner

The internal type used to represent dates

type Year = EraYear

The type of YearInfo returned by the date

type DifferenceError = Infallible

The type of error returned by until

fn from_codes( &self, era: Option<&str>, year: i32, month_code: MonthCode, day: u8, ) -> Result<Self::DateInner, DateError>

Construct a date from era/month codes and fields

fn from_rata_die(&self, rd: RataDie) -> Self::DateInner

Construct the date from a RataDie

fn to_rata_die(&self, date: &Self::DateInner) -> RataDie

Obtain a RataDie from this date

fn has_cheap_iso_conversion(&self) -> bool

Whether from_iso/to_iso is more efficient than from_rata_die/to_rata_die.

fn months_in_year(&self, date: &Self::DateInner) -> u8

Count the number of months in a given year, specified by providing a date from that year

fn days_in_year(&self, date: &Self::DateInner) -> u16

Count the number of days in a given year, specified by providing a date from that year

fn days_in_month(&self, date: &Self::DateInner) -> u8

Count the number of days in a given month, specified by providing a date from that year/month

fn year_info(&self, date: &Self::DateInner) -> Self::Year

Information about the year

fn is_in_leap_year(&self, date: &Self::DateInner) -> bool

Calculate if a date is in a leap year

fn month(&self, date: &Self::DateInner) -> MonthInfo

The calendar-specific month represented by date

fn day_of_month(&self, date: &Self::DateInner) -> DayOfMonth

The calendar-specific day-of-month represented by date

fn day_of_year(&self, date: &Self::DateInner) -> DayOfYear

Information of the day of the year

fn debug_name(&self) -> &'static str

Obtain a name for the calendar for debug printing

fn calendar_algorithm(&self) -> Option<CalendarAlgorithm>

Returns the CalendarAlgorithm that is required to match when parsing into this calendar.

fn from_iso(&self, iso: IsoDateInner) -> Self::DateInner

Construct the date from an ISO date.

fn to_iso(&self, date: &Self::DateInner) -> IsoDateInner

Obtain an ISO date from this date.

fn extended_year(&self, date: &Self::DateInner) -> i32

The extended year.

impl Clone for Persian

fn clone(&self) -> Persian

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl DateFieldsResolver for Persian

type YearInfo = i32

This stores the year as either an i32, or a type containing more useful computational information.

fn days_in_provided_month(year: i32, month: u8) -> u8

fn months_in_provided_year(_: i32) -> u8

fn year_info_from_era( &self, era: &[u8], era_year: i32, ) -> Result<Self::YearInfo, UnknownEraError>

Converts the era and era year to a YearInfo. If the calendar does not have eras, this should always return an Err result.

fn year_info_from_extended(&self, extended_year: i32) -> Self::YearInfo

Converts an extended year to a YearInfo.

fn reference_year_from_month_day( &self, month_code: ValidMonthCode, day: u8, ) -> Result<Self::YearInfo, EcmaReferenceYearError>

Calculates the ECMA reference year for the month code and day, or an error if the month code and day are invalid.

fn ordinal_month_from_code( &self, _year: &Self::YearInfo, month_code: ValidMonthCode, _options: DateFromFieldsOptions, ) -> Result<u8, MonthCodeError>

Calculates the ordinal month for the given year and month code.

fn month_code_from_ordinal( &self, _year: &Self::YearInfo, ordinal_month: u8, ) -> ValidMonthCode

Calculates the month code from the given ordinal month and year.

impl Debug for Persian

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

Formats the value using the given formatter.

impl Default for Persian

fn default() -> Persian

Returns the “default value” for a type.

impl From<Persian> for AnyCalendar

fn from(value: Persian) -> AnyCalendar

Converts to this type from the input type.

impl Hash for Persian

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 IntoAnyCalendar for Persian

fn to_any(self) -> AnyCalendar

Convert this calendar into an AnyCalendar, moving it

fn kind(&self) -> AnyCalendarKind

The AnyCalendarKind enum variant associated with this calendar

fn from_any(any: AnyCalendar) -> Result<Self, AnyCalendar>

Move an AnyCalendar into a Self, or returning it as an error if the types do not match.

fn from_any_ref(any: &AnyCalendar) -> Option<&Self>

Convert an AnyCalendar reference into a Self reference.

fn date_to_any(&self, d: &Self::DateInner) -> AnyDateInner

Convert a date for this calendar into an AnyDateInner

impl Ord for Persian

fn cmp(&self, other: &Persian) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Persian

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

fn partial_cmp(&self, other: &Persian) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for Persian

impl Eq for Persian

impl StructuralPartialEq for Persian