Module org.holiday.calendar.mena
Package org.holiday.calendar.observance.islamic.mena

Class EidAlFitr

java.lang.Object
org.holiday.calendar.observance.AbstractObservance
org.holiday.calendar.observance.islamic.mena.EidAlFitr
All Implemented Interfaces:
Function<Integer,LocalDate>, Predicate<Integer>, Observance
public class EidAlFitr extends AbstractObservance
Observance of Eid al-Fitr, marking the end of Ramadan (1 Shawwal AH).

Dates are determined by official moon sighting and cannot be computed algorithmically. Dates for 2024–2026 are sourced from official UAE Securities and Commodities Authority (SCA) and Saudi Exchange (Tadawul) holiday announcements. Dates for 2027–2055 are projected from the Umm al-Qura tabular Islamic calendar; verify against official announcements as each year is published.

Note: Gregorian year 2033 contains two Eid al-Fitr occurrences (~January 4 and ~December 24). Only the first (January) occurrence is recorded; the December occurrence cannot be represented under the single-date-per-year-key design.

Date data is loaded at runtime from eid-al-fitr-{countryCode}.csv in this package, where countryCode is the ISO 3166-1 alpha-2 country code in lower case (e.g. ae, sa).

Author:
Dave Joyce

  • Constructor Details

    • EidAlFitr

      public EidAlFitr(String countryCode)

  • Method Details

    • computeDate

      protected LocalDate computeDate(int year)
      Description copied from class: AbstractObservance
      Compute the date for this observance in the given year. Only called when AbstractObservance.isValidYear(int) returns true.
      Specified by:
      computeDate in class AbstractObservance
      Parameters:
      year - the year for which to compute the date
      Returns:
      computed holiday date

    • isValidYear

      protected boolean isValidYear(int year)
      Description copied from class: AbstractObservance
      Determine whether this observance applies in the given year. Defaults to true (all years are valid).
      Overrides:
      isValidYear in class AbstractObservance
      Parameters:
      year - the year to test
      Returns:
      true if this observance applies