Add Jersey holidays

README.rst

@@ -142,7 +142,7 @@ Available Countries
 .. _ISO 639-1 code: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
 .. _ISO 639-2 code: https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
 
-We currently support 141 country codes. The standard way to refer to a country
+We currently support 142 country codes. The standard way to refer to a country
 is by using its `ISO 3166-1 alpha-2 code`_, the same used for domain names, and
 for a subdivision its `ISO 3166-2 code`_. Some of the countries support more
 than one language for holiday names output.
@@ -518,6 +518,11 @@ All other default values are highlighted with bold:
      -
      - en_US, **ja**, th
      - BANK
+   * - Jersey
+     - JE
+     -
+     -
+     -
    * - Kazakhstan
      - KZ
      -

holidays/countries/__init__.py

@@ -80,6 +80,7 @@
 from .italy import Italy, IT, ITA
 from .jamaica import Jamaica, JM, JAM
 from .japan import Japan, JP, JPN
+from .jersey import Jersey, JE, JEY
 from .kazakhstan import Kazakhstan, KZ, KAZ
 from .kenya import Kenya, KE, KEN
 from .kyrgyzstan import Kyrgyzstan, KG, KGZ

holidays/countries/jersey.py

@@ -0,0 +1,246 @@
+#  python-holidays
+#  ---------------
+#  A fast, efficient Python library for generating country, province and state
+#  specific sets of holidays on the fly. It aims to make determining whether a
+#  specific date is a holiday as fast and flexible as possible.
+#
+#  Authors: dr-prodigy <[email protected]> (c) 2017-2023
+#           ryanss <[email protected]> (c) 2014-2017
+#  Website: https://github.com/dr-prodigy/python-holidays
+#  License: MIT (see LICENSE file)
+
+from datetime import date
+from typing import Tuple
+
+from holidays.calendars.gregorian import JAN, APR, MAY, JUN, JUL, SEP, OCT, DEC
+from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
+from holidays.observed_holiday_base import (
+    ObservedHolidayBase,
+    SAT_SUN_TO_NEXT_MON,
+    SAT_SUN_TO_NEXT_MON_TUE,
+    SUN_TO_NEXT_MON,
+    SUN_TO_NEXT_TUE,
+)
+
+
+class Jersey(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
+    """
+    References:
+      - https://en.wikipedia.org/wiki/Public_holidays_in_Jersey
+      - https://www.jerseylaw.je/laws/current/Pages/15.560.20.aspx # 2010 Revision
+      - https://www.jerseylaw.je/laws/superseded/Pages/2006/15.560.20.aspx # 1952 Revision
+      - https://www.jerseylaw.je/laws/enacted/Pages/RO-3038.aspx # 1952 as enacted
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20RO%205331.aspx # Bank Holidays
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20RO%206795.aspx # May Day
+    Checked with:
+      - https://www.gov.je/Leisure/Events/WhatsOn/pages/bankholidaydates.aspx # From 2010 onwards
+
+    This has only been cross-checked with the official source from 2010 onwards.
+
+    Jersey has the same public holidays as the United Kingdom (England Subdivision)
+    - plus an extra day on 9 May, to mark Liberation Day (ignoring special holidays
+    like the Corn Riots Anniversary in 2021).
+
+    If a bank holiday is on a sunday, a substitute weekday becomes a bank holiday,
+    normally the following Monday. From 2004 onwards this also applies to saturday.
+    """
+
+    country = "JE"
+    observed_label = "%s (observed)"
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        StaticHolidays.__init__(self, JerseyStaticHolidays)
+        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_MON)
+        ObservedHolidayBase.__init__(self, *args, **kwargs)
+
+    def _add_observed(self, dt: date, **kwargs) -> Tuple[bool, date]:
+        # Prior to 2004, in-lieu are only given for Sundays.
+        # https://www.jerseylaw.je/laws/enacted/Pages/RO-123-2004.aspx
+        kwargs.setdefault(
+            "rule", SUN_TO_NEXT_MON if dt < date(2004, OCT, 12) else self._observed_rule
+        )
+        return super()._add_observed(dt, **kwargs)
+
+    def _populate_public_holidays(self) -> None:
+        # Earliest available piece of law available is from 1952.
+        if self._year <= 1951:
+            return None
+
+        # Good Friday
+        self._add_good_friday("Good Friday")
+
+        # May Day
+        # This only starts in 1980 (instead of 1978) for Jersey.
+        # The date is not moved in 2020 (unlike in the UK) as there's already VE Day Celebrations.
+
+        # May Day bank holiday (first Monday in May)
+        if self._year >= 1980:
+            name = "May Day"
+            if self._year == 1995:
+                self._add_holiday_may_8(name)
+            else:
+                self._add_holiday_1st_mon_of_may(name)
+
+        # Spring bank holiday
+        # Current Pattern started in 1970 for Jersey.
+
+        # Spring bank holiday (last Monday in May)
+        if self._year >= 1970:
+            spring_bank_dates = {
+                2002: (JUN, 4),
+                2012: (JUN, 4),
+                2022: (JUN, 2),
+            }
+            name = "Spring Bank Holiday"
+            if self._year in spring_bank_dates:
+                self._add_holiday(name, spring_bank_dates[self._year])
+            else:
+                self._add_holiday_last_mon_of_may(name)
+
+        # Whit Monday.
+        # Was in-use prior to Spring bank holiday adoption.
+
+        if self._year <= 1969:
+            # Whit Monday.
+            self._add_whit_monday("Whit Monday")
+
+        # Easter Monday
+        self._add_easter_monday("Easter Monday")
+
+        # Late Summer Bank Holiday
+        # Current Pattern started in 1970. Was previously first Monday of September for Jersey.
+
+        # Late Summer bank holiday (last Monday in August)
+        summer_bank_holiday = "Late Summer Bank Holiday"
+        if self._year >= 1970:
+            self._add_holiday_last_mon_of_aug(summer_bank_holiday)
+        else:
+            self._add_holiday_1st_mon_of_sep(summer_bank_holiday)
+
+        # Jersey exclusive holidays
+
+        # Liberation Day.
+        # Started in 1952. This has no in-lieus.
+        # Counts as Public Holiday when fall on the weekdays, also on Saturday from 2010 onwards.
+        # Specially held in 2010 on Sunday for the 65th Anniversary.
+
+        if self._year >= 1952:
+            # Liberation Day
+            liberation_day = self._add_holiday_may_9("Liberation Day")
+            if (self._is_sunday(liberation_day) and self._year != 2010) or (
+                self._is_saturday(liberation_day) and self._year <= 2010
+            ):
+                self.pop(liberation_day)
+
+    def _populate_subdiv_holidays(self):
+        # Earliest available piece of law available is from 1952.
+        if self._year <= 1951:
+            return None
+
+        # New Year's Day.
+        # Available online source shown that this was celebrated since at least 1952.
+        # Was briefly removed in 1983 only to be added back again before that came to effect.
+
+        # New Year's Day
+        self._add_observed(self._add_new_years_day("New Year's Day"))
+
+        # Christmas Day
+        christmas_day = self._add_christmas_day("Christmas Day")
+
+        # Boxing Day
+        boxing_day = self._add_christmas_day_two("Boxing Day")
+
+        if self._year >= 2004:
+            self._add_observed(christmas_day, rule=SAT_SUN_TO_NEXT_MON_TUE)
+            self._add_observed(boxing_day, rule=SAT_SUN_TO_NEXT_MON_TUE)
+        else:
+            self._add_observed(christmas_day, rule=SUN_TO_NEXT_TUE)
+            self._add_observed(boxing_day)
+
+
+class JE(Jersey):
+    pass
+
+
+class JEY(Jersey):
+    pass
+
+
+class JerseyStaticHolidays:
+    """
+    References:
+      - https://www.gov.je/News/2019/pages/vedaypublicholiday8may.aspx
+      - https://www.gov.je/news/2021/pages/cornriots.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20R%20%20O%209288.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20R%20%20O%209317.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20RO%2042-2001.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20RO%206350.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20RO%206514.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20RO%206924.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20RO%207689.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20RO%207877.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20RO%208451.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/Jersey%20RO%208596.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/RO-050-2021.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/RO-108-2009.aspx
+      - https://www.jerseylaw.je/laws/enacted/Pages/RO-3038.aspx
+    """
+
+    # Mostly a direct copy of UnitedKingdomStaticHolidays.
+
+    # Jersey Specifics:
+    #   - Queen Elizabeth II's Royal Visit (1957, 1978, 1989)*
+    #        *2004 one falls on existing Liberation Day, source on 2001 ones declared
+    #         as public holiday not available.
+    #   - 75th VE Day Anniversary (2020) (May Day also moved from original schedule)
+    #   - 250th Corn Riots/Code of 1771 Anniversary (2021).
+
+    # Jersey-specific Special Observance
+    #   - New Year's Day (1977, 1983, 1994, 2000)
+    #   - Boxing Day (1976, 1981, 1987, 1992, 1993, 1998, 1999, 2009)
+
+    # New Year's Day
+    new_years_day_in_lieu = "New Year's Day"
+
+    # Boxing Day
+    boxing_day_in_lieu = "Boxing Day"
+
+    # Elizabeth II's Royal Visit.
+    elizabeth_2_royal_visit = "Elizabeth II's Royal Visit"
+
+    special_public_holidays = {
+        1957: (JUL, 26, elizabeth_2_royal_visit),
+        1977: (JUN, 7, "Silver Jubilee of Elizabeth II"),
+        1978: (JUN, 27, elizabeth_2_royal_visit),
+        1981: (JUL, 29, "Wedding of Charles and Diana"),
+        1989: (MAY, 25, elizabeth_2_royal_visit),
+        1999: (DEC, 31, "Millennium Celebrations"),
+        2001: (JUL, 13, elizabeth_2_royal_visit),
+        2002: (JUN, 3, "Golden Jubilee of Elizabeth II"),
+        2011: (APR, 29, "Wedding of William and Catherine"),
+        2012: (JUN, 5, "Diamond Jubilee of Elizabeth II"),
+        2020: (MAY, 8, "75th Anniversary of VE Day"),
+        2021: (SEP, 27, "250th Anniversary of the 1769 Corn Riots"),
+        2022: (
+            (JUN, 3, "Platinum Jubilee of Elizabeth II"),
+            (SEP, 19, "State Funeral of Queen Elizabeth II"),
+        ),
+        2023: (MAY, 8, "Coronation of Charles III"),
+    }
+    special_public_holidays_observed = {
+        1976: (DEC, 28, boxing_day_in_lieu),
+        1977: (JAN, 3, new_years_day_in_lieu),
+        1981: (DEC, 28, boxing_day_in_lieu),
+        1982: (DEC, 28, boxing_day_in_lieu),
+        1983: (JAN, 3, new_years_day_in_lieu),
+        1987: (DEC, 28, boxing_day_in_lieu),
+        1992: (DEC, 28, boxing_day_in_lieu),
+        1993: (DEC, 28, boxing_day_in_lieu),
+        1994: (JAN, 3, new_years_day_in_lieu),
+        1998: (DEC, 28, boxing_day_in_lieu),
+        1999: (DEC, 28, boxing_day_in_lieu),
+        2000: (JAN, 3, new_years_day_in_lieu),
+        2009: (DEC, 28, boxing_day_in_lieu),
+    }

holidays/registry.py

@@ -86,6 +86,7 @@
     "italy": ("Italy", "IT", "ITA"),
     "jamaica": ("Jamaica", "JM", "JAM"),
     "japan": ("Japan", "JP", "JPN"),
+    "jersey": ("Jersey", "JE", "JEY"),
     "kazakhstan": ("Kazakhstan", "KZ", "KAZ"),
     "kenya": ("Kenya", "KE", "KEN"),
     "kyrgyzstan": ("Kyrgyzstan", "KG", "KGZ"),