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

Class IslamicNewYear

java.lang.Object
org.holiday.calendar.observance.AbstractObservance
org.holiday.calendar.observance.islamic.mena.IslamicNewYear
All Implemented Interfaces:
Function<Integer,LocalDate>, Predicate<Integer>, Observance
public class IslamicNewYear extends AbstractObservance
Observance of Islamic New Year (1 Muharram AH), the first day of the Islamic lunar calendar year.

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.

Date data is loaded at runtime from islamic-new-year-{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

    • IslamicNewYear

      public IslamicNewYear(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