Struct Hebrew 

pub struct Hebrew;

The Hebrew Calendar

The Hebrew calendar is a lunisolar calendar used as the Jewish liturgical calendar as well as an official calendar in Israel.

This implementation uses civil month numbering, where Tishrei is the first month of the year.

The precise algorithm used to calculate the Hebrew Calendar has changed over time, with the modern one being in place since about 4536 AM (776 CE). This implementation extends proleptically for dates before that.

This corresponds to the "hebrew" CLDR calendar.

Era codes

This calendar uses a single era code am, Anno Mundi. Dates before this era use negative years.

Months and days

The 12 months are called Tishrei (M01, 30 days), Ḥešvan (M02, 29/30 days), Kīslev (M03, 30/29 days), Ṭevet (M04, 29 days), Šəvaṭ (M05, 30 days), ʾĂdār (M06, 29 days), Nīsān (M07, 30 days), ʾĪyyar (M08, 29 days), Sivan (M09, 30 days), Tammūz (M10, 29 days), ʾAv (M11, 30 days), ʾElūl (M12, 29 days).

Due to Rosh Hashanah postponement rules, Ḥešvan and Kislev vary in length.

In leap years (years 3, 6, 8, 11, 17, 19 in a 19-year cycle), the leap month Adar I (M05L, 30 days) is inserted before Adar, and Adar is called Adar II (the formatting_code returned by MonthInfo will be M06L to mark this, while the standard_code remains M06).

Standard years thus have 353-355 days, and leap years 383-385.

Implementations

impl Hebrew

pub fn new() -> Self

Construct a new Hebrew

Trait Implementations

impl Calendar for Hebrew

type DateInner = HebrewDateInner

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 debug_name(&self) -> &'static str

Obtain a name for the calendar for debug printing

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 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 Hebrew

fn clone(&self) -> Hebrew

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl DateFieldsResolver for Hebrew

type YearInfo = HebrewYearInfo

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

fn days_in_provided_month(info: HebrewYearInfo, ordinal_month: u8) -> u8

fn months_in_provided_year(info: HebrewYearInfo) -> 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 Hebrew

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

Formats the value using the given formatter.

impl Default for Hebrew

fn default() -> Hebrew

Returns the “default value” for a type.

impl From<Hebrew> for AnyCalendar

fn from(value: Hebrew) -> AnyCalendar

Converts to this type from the input type.

impl Hash for Hebrew

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 Hebrew

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 Hebrew

fn cmp(&self, other: &Hebrew) -> 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 Hebrew

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

fn partial_cmp(&self, other: &Hebrew) -> 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 Hebrew

impl Eq for Hebrew

impl StructuralPartialEq for Hebrew