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

Class ProphetsBirthday

java.lang.Object
org.holiday.calendar.observance.AbstractObservance
org.holiday.calendar.observance.islamic.mena.ProphetsBirthday
All Implemented Interfaces:
Function<Integer,LocalDate>, Predicate<Integer>, Observance
public class ProphetsBirthday extends AbstractObservance
Observance of the Prophet's Birthday (Mawlid an-Nabi), commemorating the birth of the Prophet Muhammad (12 Rabi' al-Awwal 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: Saudi Arabia does not officially observe Mawlid as a public holiday for financial markets; include only when the relevant exchange/regulator confirms it as a closure day.

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

    • ProphetsBirthday

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