Trait calendrical_calculations::islamic::IslamicBasedMarker

pub trait IslamicBasedMarker {
    const EPOCH: RataDie;
    const DEBUG_NAME: &'static str;
    const HAS_353_DAY_YEARS: bool;

    // Required methods
    fn fixed_from_islamic(year: i32, month: u8, day: u8) -> RataDie;
    fn islamic_from_fixed(date: RataDie) -> (i32, u8, u8);

    // Provided methods
    fn mean_synodic_ny(extended_year: i32) -> RataDie { ... }
    fn approximate_islamic_from_fixed(date: RataDie) -> i32 { ... }
    fn month_lengths_for_year(extended_year: i32, ny: RataDie) -> [bool; 12] { ... }
}

Common abstraction over islamic-style calendars

Required Associated Constants

const EPOCH: RataDie

The epoch of the calendar. Different calendars use a different epoch (Thu or Fri) due to disagreement on the exact date of Mohammed’s migration to Mecca.

const DEBUG_NAME: &'static str

The name of the calendar for debugging.

const HAS_353_DAY_YEARS: bool

Whether this calendar is known to have 353-day years. This is probably a bug; see https://github.com/unicode-org/icu4x/issues/4930

Required Methods

fn fixed_from_islamic(year: i32, month: u8, day: u8) -> RataDie

Convert an islamic date in this calendar to a R.D.

fn islamic_from_fixed(date: RataDie) -> (i32, u8, u8)

Convert an R.D. To an islamic date in this calendar

Provided Methods

fn mean_synodic_ny(extended_year: i32) -> RataDie

Given the extended year, calculate the approximate new year using the mean synodic month

fn approximate_islamic_from_fixed(date: RataDie) -> i32

Given an iso date, calculate the approximate islamic year it corresponds to (for quick cache lookup)

fn month_lengths_for_year(extended_year: i32, ny: RataDie) -> [bool; 12]

Given an extended year, calculate whether each month is 29 or 30 days long

Object Safety

This trait is not object safe.

Implementors

impl IslamicBasedMarker for CivilIslamicMarker

const EPOCH: RataDie = FIXED_ISLAMIC_EPOCH_FRIDAY

const DEBUG_NAME: &'static str = "CivilIslamic"

const HAS_353_DAY_YEARS: bool = false

impl IslamicBasedMarker for ObservationalIslamicMarker

const EPOCH: RataDie = FIXED_ISLAMIC_EPOCH_FRIDAY

const DEBUG_NAME: &'static str = "ObservationalIslamic"

const HAS_353_DAY_YEARS: bool = true

impl IslamicBasedMarker for SaudiIslamicMarker

const EPOCH: RataDie = FIXED_ISLAMIC_EPOCH_FRIDAY

const DEBUG_NAME: &'static str = "SaudiIslamic"

const HAS_353_DAY_YEARS: bool = true

impl IslamicBasedMarker for TabularIslamicMarker

const EPOCH: RataDie = FIXED_ISLAMIC_EPOCH_THURSDAY

const DEBUG_NAME: &'static str = "TabularIslamic"

const HAS_353_DAY_YEARS: bool = false