holidays 0.76__py3-none-any.whl → 0.77__py3-none-any.whl

holidays/countries/__init__.py

@@ -46,12 +46,16 @@ from holidays.countries.brunei import Brunei, BN, BRN
 from holidays.countries.bulgaria import Bulgaria, BG, BLG
 from holidays.countries.burkina_faso import BurkinaFaso, BF, BFA
 from holidays.countries.burundi import Burundi, BI, BDI
+from holidays.countries.cabo_verde import CaboVerde, CV, CPV
 from holidays.countries.cambodia import Cambodia, KH, KHM
 from holidays.countries.cameroon import Cameroon, CM, CMR
 from holidays.countries.canada import Canada, CA, CAN
+from holidays.countries.cayman_islands import CaymanIslands, KY, CYM
+from holidays.countries.central_african_republic import CentralAfricanRepublic, CF, CAF
 from holidays.countries.chad import Chad, TD, TCD
 from holidays.countries.chile import Chile, CL, CHL
 from holidays.countries.china import China, CN, CHN
+from holidays.countries.christmas_island import ChristmasIsland, CX, CXR
 from holidays.countries.cocos_islands import CocosIslands, CC, CCK
 from holidays.countries.colombia import Colombia, CO, COL
 from holidays.countries.congo import Congo, CG, COG
@@ -66,6 +70,7 @@ from holidays.countries.denmark import Denmark, DK, DNK
 from holidays.countries.djibouti import Djibouti, DJ, DJI
 from holidays.countries.dominica import Dominica, DM, DMA
 from holidays.countries.dominican_republic import DominicanRepublic, DO, DOM
+from holidays.countries.dr_congo import DRCongo, CD, COD
 from holidays.countries.ecuador import Ecuador, EC, ECU
 from holidays.countries.egypt import Egypt, EG, EGY
 from holidays.countries.el_salvador import ElSalvador, SV, SLV
@@ -74,6 +79,7 @@ from holidays.countries.estonia import Estonia, EE, EST
 from holidays.countries.eswatini import Eswatini, SZ, SZW, Swaziland
 from holidays.countries.ethiopia import Ethiopia, ET, ETH
 from holidays.countries.falkland_islands import FalklandIslands, FK, FLK
+from holidays.countries.faroe_islands import FaroeIslands, FO, FRO
 from holidays.countries.fiji import Fiji, FJ, FJI
 from holidays.countries.finland import Finland, FI, FIN
 from holidays.countries.france import France, FR, FRA
@@ -89,6 +95,7 @@ from holidays.countries.gabon import Gabon, GA, GAB
 from holidays.countries.georgia import Georgia, GE, GEO
 from holidays.countries.germany import Germany, DE, DEU
 from holidays.countries.ghana import Ghana, GH, GHA
+from holidays.countries.gibraltar import Gibraltar, GI, GIB
 from holidays.countries.greece import Greece, GR, GRC
 from holidays.countries.greenland import Greenland, GL, GRL
 from holidays.countries.grenada import Grenada, GD, GRD
@@ -121,6 +128,7 @@ from holidays.countries.kuwait import Kuwait, KW, KWT
 from holidays.countries.kyrgyzstan import Kyrgyzstan, KG, KGZ
 from holidays.countries.laos import Laos, LA, LAO
 from holidays.countries.latvia import Latvia, LV, LVA
+from holidays.countries.lebanon import Lebanon, LB, LBN
 from holidays.countries.lesotho import Lesotho, LS, LSO
 from holidays.countries.libya import Libya, LY, LBY
 from holidays.countries.liechtenstein import Liechtenstein, LI, LIE
@@ -131,6 +139,7 @@ from holidays.countries.madagascar import Madagascar, MG, MDG
 from holidays.countries.malawi import Malawi, MW, MWI
 from holidays.countries.malaysia import Malaysia, MY, MYS
 from holidays.countries.maldives import Maldives, MV, MDV
+from holidays.countries.mali import Mali, ML, MLI
 from holidays.countries.malta import Malta, MT, MLT
 from holidays.countries.marshall_islands import MarshallIslands, MH, MHL, HolidaysMH
 from holidays.countries.martinique import Martinique, MQ, MTQ, HolidaysMQ
@@ -143,6 +152,7 @@ from holidays.countries.moldova import Moldova, MD, MDA
 from holidays.countries.monaco import Monaco, MC, MCO
 from holidays.countries.mongolia import Mongolia, MN, MNG
 from holidays.countries.montenegro import Montenegro, ME, MNE
+from holidays.countries.montserrat import Montserrat, MS, MSR
 from holidays.countries.morocco import Morocco, MA, MOR
 from holidays.countries.mozambique import Mozambique, MZ, MOZ
 from holidays.countries.namibia import Namibia, NA, NAM
@@ -154,12 +164,15 @@ from holidays.countries.new_zealand import NewZealand, NZ, NZL
 from holidays.countries.nicaragua import Nicaragua, NI, NIC
 from holidays.countries.niger import Niger, NE, NER
 from holidays.countries.nigeria import Nigeria, NG, NGA
+from holidays.countries.niue import Niue, NU, NIU
+from holidays.countries.norfolk_island import NorfolkIsland, NF, NFK
 from holidays.countries.north_macedonia import NorthMacedonia, MK, MKD
 from holidays.countries.northern_mariana_islands import NorthernMarianaIslands, MP, MNP, HolidaysMP
 from holidays.countries.norway import Norway, NO, NOR
 from holidays.countries.oman import Oman, OM, OMN
 from holidays.countries.pakistan import Pakistan, PK, PAK
 from holidays.countries.palau import Palau, PW, PLW
+from holidays.countries.palestine import Palestine, PS, PSE
 from holidays.countries.panama import Panama, PA, PAN
 from holidays.countries.papua_new_guinea import PapuaNewGuinea, PG, PNG
 from holidays.countries.paraguay import Paraguay, PY, PRY
@@ -182,6 +195,11 @@ from holidays.countries.saint_pierre_and_miquelon import (
     SPM,
     HolidaysPM,
 )
+from holidays.countries.saint_vincent_and_the_grenadines import (
+    SaintVincentAndTheGrenadines,
+    VC,
+    VCT,
+)
 from holidays.countries.samoa import Samoa, WS, WSM
 from holidays.countries.san_marino import SanMarino, SM, SMR
 from holidays.countries.sao_tome_and_principe import SaoTomeAndPrincipe, ST, STP
@@ -208,6 +226,7 @@ from holidays.countries.tanzania import Tanzania, TZ, TZA
 from holidays.countries.thailand import Thailand, TH, THA
 from holidays.countries.timor_leste import TimorLeste, TL, TLS
 from holidays.countries.togo import Togo, TG, TGO
+from holidays.countries.tokelau import Tokelau, TK, TKL
 from holidays.countries.tonga import Tonga, TO, TON
 from holidays.countries.trinidad_and_tobago import TrinidadAndTobago, TT, TTO
 from holidays.countries.tunisia import Tunisia, TN, TUN

holidays/countries/australia.py

@@ -529,8 +529,8 @@ class Australia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, S
         }
         # The Royal Queensland Show.
         name = tr("The Royal Queensland Show")
-        if self._year in ekka_dates:
-            self._add_holiday(name, ekka_dates[self._year])
+        if dt := ekka_dates.get(self._year):
+            self._add_holiday(name, dt)
         else:
             # [1st FRI after Aug 5] + 5 days = [1st WED after Aug 10]
             self._add_holiday_1st_wed_from_aug_10(name)
@@ -839,8 +839,8 @@ class Australia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, S
             }
             # Grand Final Day.
             name = tr("Grand Final Day")
-            if self._year in grand_final_dates:
-                self._add_holiday(name, grand_final_dates[self._year])
+            if dt := grand_final_dates.get(self._year):
+                self._add_holiday(name, dt)
             else:
                 self._add_holiday_1_day_prior_last_sat_of_sep(name)
 
@@ -937,10 +937,8 @@ class Australia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, S
                     2012: (OCT, 1),
                     2024: (SEP, 23),
                 }
-                if self._year in sovereign_birthday_dates:
-                    self._add_holiday(
-                        self.sovereign_birthday, sovereign_birthday_dates[self._year]
-                    )
+                if dt := sovereign_birthday_dates.get(self._year):
+                    self._add_holiday(self.sovereign_birthday, dt)
                 else:
                     self._add_holiday_last_mon_of_sep(self.sovereign_birthday)
             else:

holidays/countries/british_virgin_islands.py

@@ -89,8 +89,8 @@ class BritishVirginIslands(
                 2019: (JUN, 7),
                 2023: (JUN, 16),
             }
-            if self._year in sovereign_birthday_dates:
-                self._add_holiday(name, sovereign_birthday_dates[self._year])
+            if dt := sovereign_birthday_dates.get(self._year):
+                self._add_holiday(name, dt)
             else:
                 self._add_holiday_2nd_fri_of_jun(name)
         else:
@@ -110,8 +110,8 @@ class BritishVirginIslands(
             2015: (JUN, 29),
             2020: (JUN, 29),
         }
-        if self._year in territory_day_dates:
-            self._add_holiday(name, territory_day_dates[self._year])
+        if dt := territory_day_dates.get(self._year):
+            self._add_holiday(name, dt)
         else:
             if self._year >= 2021:
                 self._add_holiday_1st_mon_of_jul(name)
@@ -151,8 +151,8 @@ class BritishVirginIslands(
                 2015: (OCT, 19),
                 2020: (OCT, 23),
             }
-            if self._year in saint_ursula_dates:
-                self._add_holiday(name, saint_ursula_dates[self._year])
+            if dt := saint_ursula_dates.get(self._year):
+                self._add_holiday(name, dt)
             else:
                 self._add_observed(
                     self._add_holiday_oct_21(name), rule=SAT_TO_PREV_FRI + SUN_TO_NEXT_MON

holidays/countries/cabo_verde.py

@@ -0,0 +1,293 @@
+#  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: Vacanza Team and individual contributors (see CONTRIBUTORS file)
+#           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/vacanza/holidays
+#  License: MIT (see LICENSE file)
+
+from gettext import gettext as tr
+
+from holidays.constants import OPTIONAL, PUBLIC
+from holidays.groups import ChristianHolidays, InternationalHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class CaboVerde(HolidayBase, ChristianHolidays, InternationalHolidays):
+    """Cabo Verde holidays.
+
+    References:
+        * [Public holidays in Cape Verde](https://en.wikipedia.org/wiki/Public_holidays_in_Cape_Verde)
+        * [Legislação Municipal Cabo-Verdiana](https://web.archive.org/web/20180820172827/http://www.interface.gov.cv/index.php?option=com_docman&task=doc_download&gid=12&Itemid=314)
+        * [Feriados Bancários - Banco de Cabo Verde](https://web.archive.org/web/20250629042854/https://www.bcv.cv/pt/SistemadePagamentos/feriados_bancarios/Paginas/FeriadosBancarios.aspx)
+        * [Feriados Públicos - Feel Cabo Verde](https://web.archive.org/web/20250419201823/https://feelcaboverde.com/feriados-publicos/)
+        * [Public Holidays - Feel Cape Verde](https://web.archive.org/web/20250419202739/https://feelcaboverde.com/en/public-holidays-cape-verde/)
+        * [Democracy Day](https://web.archive.org/web/20250420093850/https://cmsv.cv/dia-da-liberdade-e-democracia-de-cabo-verde/)
+    """
+
+    country = "CV"
+    default_language = "pt_CV"
+    start_year = 1976
+    subdivisions = (
+        "BR",  # Brava.
+        "BV",  # Boa Vista.
+        "CA",  # Santa Catarina.
+        "CF",  # Santa Catarina do Fogo.
+        "CR",  # Santa Cruz.
+        "MA",  # Maio.
+        "MO",  # Mosteiros.
+        "PA",  # Paul.
+        "PN",  # Porto Novo.
+        "PR",  # Praia.
+        "RB",  # Ribeira Brava
+        "RG",  # Ribeira Grande.
+        "RS",  # Ribeira Grande de Santiago.
+        "SD",  # São Domingos.
+        "SF",  # São Filipe.
+        "SL",  # Sal.
+        "SM",  # São Miguel.
+        "SO",  # São Lourenço dos Órgãos.
+        "SS",  # São Salvador do Mundo.
+        "SV",  # São Vicente.
+        "TA",  # Tarrafal.
+        "TS",  # Tarrafal de São Nicolau.
+    )
+
+    subdivisions_aliases = {
+        "Brava": "BR",
+        "Boa Vista": "BV",
+        "Santa Catarina": "CA",
+        "Santa Catarina do Fogo": "CF",
+        "Santa Cruz": "CR",
+        "Maio": "MA",
+        "Mosteiros": "MO",
+        "Paul": "PA",
+        "Porto Novo": "PN",
+        "Praia": "PR",
+        "Ribeira Brava": "RB",
+        "Ribeira Grande": "RG",
+        "Ribeira Grande de Santiago": "RS",
+        "São Domingos": "SD",
+        "São Filipe": "SF",
+        "Sal": "SL",
+        "São Miguel": "SM",
+        "São Lourenço dos Órgãos": "SO",
+        "São Salvador do Mundo": "SS",
+        "São Vicente": "SV",
+        "Tarrafal": "TA",
+        "Tarrafal de São Nicolau": "TS",
+    }
+    supported_categories = (OPTIONAL, PUBLIC)
+    supported_languages = ("de", "en_US", "es", "fr", "pt_CV")
+
+    def __init__(self, *args, **kwargs) -> None:
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day(tr("Ano Novo"))
+
+        # Law # 95/V/99 of March 22nd.
+        if self._year >= 2000:
+            # Democracy and Freedom Day.
+            self._add_holiday_jan_13(tr("Dia da Liberdade e da Democracia"))
+
+        # National Heroes Day.
+        self._add_holiday_jan_20(tr("Dia da Nacionalidade e dos Heróis Nacionais"))
+
+        # Ash Wednesday.
+        self._add_ash_wednesday(tr("Quarta-feira de Cinzas"))
+
+        # Good Friday.
+        self._add_good_friday(tr("Sexta-feira Santa"))
+
+        # Easter Sunday.
+        self._add_easter_sunday(tr("Páscoa"))
+
+        # Worker's Day.
+        self._add_labor_day(tr("Dia do Trabalhador"))
+
+        # Law # 69/VI/2005 of May 31st.
+        if self._year >= 2005:
+            # International Children's Day.
+            self._add_childrens_day(tr("Dia Mundial da Criança"))
+
+        # Independence Day.
+        self._add_holiday_jul_5(tr("Dia da Independência Nacional"))
+
+        # Assumption Day.
+        self._add_assumption_of_mary_day(tr("Dia da Assunção"))
+
+        # All Saints' Day.
+        self._add_all_saints_day(tr("Dia de Todos os Santos"))
+
+        # Christmas Day.
+        self._add_christmas_day(tr("Dia do Natal"))
+
+    def _populate_optional_holidays(self):
+        # Holy Thursday.
+        self._add_holy_thursday(tr("Quinta-Feira Santa"))
+
+        # Mother's Day.
+        self._add_holiday_2nd_sun_of_may(tr("Dia das Mães"))
+
+        # Father's Day.
+        self._add_holiday_3rd_sun_of_jun(tr("Dia dos Pais"))
+
+    def _populate_subdiv_br_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # Brava Municipality Day.
+            self._add_holiday_jun_24(tr("Dia do Município da Brava"))
+
+    def _populate_subdiv_bv_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # Boa Vista Municipality Day.
+            self._add_holiday_jul_4(tr("Dia do Município da Boa Vista"))
+
+    def _populate_subdiv_ca_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1982:
+            # Santa Catarina de Santiago Municipality Day.
+            self._add_holiday_nov_25(tr("Dia do Município de Santa Catarina de Santiago"))
+
+    def _populate_subdiv_cf_public_holidays(self):
+        # Law # 66/VI/2005 of May 9th.
+        if self._year >= 2005:
+            # Santa Catarina do Fogo Municipality Day.
+            self._add_holiday_nov_25(tr("Dia do Município de Santa Catarina do Fogo"))
+
+    def _populate_subdiv_cr_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # Santa Cruz Municipality Day.
+            self._add_holiday_jul_25(tr("Dia do Município de Santa Cruz"))
+
+    def _populate_subdiv_ma_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # Maio Municipality Day.
+            self._add_holiday_sep_8(tr("Dia do Município do Maio"))
+
+    def _populate_subdiv_mo_public_holidays(self):
+        # Law # 23/IV/91 of December 30th.
+        if self._year >= 1992:
+            # Mosteiros Municipality Day.
+            self._add_holiday_aug_15(tr("Dia do Município dos Mosteiros"))
+
+    def _populate_subdiv_pa_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # Santo Antão Island Day.
+            self._add_holiday_jan_17(tr("Dia da Ilha de Santo Antão"))
+
+            # Paúl Municipality Day.
+            self._add_holiday_jun_13(tr("Dia do Município do Paúl"))
+
+    def _populate_subdiv_pn_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # Santo Antão Island Day.
+            self._add_holiday_jan_17(tr("Dia da Ilha de Santo Antão"))
+
+            # Porto Novo Municipality Day.
+            self._add_holiday_sep_2(tr("Dia do Município do Porto Novo"))
+
+    def _populate_subdiv_pr_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # Praia Municipality Day.
+            self._add_holiday_may_19(tr("Dia do Município da Praia"))
+
+    def _populate_subdiv_rb_public_holidays(self):
+        # Law # 67/VI/2005 of May 9th.
+        if self._year >= 2005:
+            # Ribeira Brava Municipality Day.
+            self._add_holiday_dec_6(tr("Dia do Município de Ribeira Brava"))
+
+    def _populate_subdiv_rg_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # Santo Antão Island Day.
+            self._add_holiday_jan_17(tr("Dia da Ilha de Santo Antão"))
+
+            # Ribeira Grande Municipality Day.
+            self._add_holiday_may_7(tr("Dia do Município de Ribeira Grande"))
+
+    def _populate_subdiv_rs_public_holidays(self):
+        # Law # 63/VI/2005 of May 9th.
+        if self._year >= 2006:
+            # Ribeira Grande de Santiago Municipality Day.
+            self._add_holiday_jan_31(tr("Dia do Município de Ribeira Grande de Santiago"))
+
+    def _populate_subdiv_sd_public_holidays(self):
+        # Law # 96/IV/93 of December 31st.
+        if self._year >= 1994:
+            # São Domingos Municipality Day.
+            self._add_holiday_mar_13(tr("Dia do Município de São Domingos"))
+
+    def _populate_subdiv_sf_public_holidays(self):
+        # Law # 23/IV/91 of December 30th.
+        if self._year >= 1992:
+            # São Filipe Municipality Day.
+            self._add_holiday_may_1(tr("Dia do Município de São Filipe"))
+
+    def _populate_subdiv_sl_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # Sal Municipality Day.
+            self._add_holiday_sep_15(tr("Dia do Município do Sal"))
+
+    def _populate_subdiv_sm_public_holidays(self):
+        # Law # 11/V/96 of November 11th.
+        if self._year >= 1997:
+            # São Miguel Municipality Day.
+            self._add_holiday_sep_29(tr("Dia do Município de São Miguel"))
+
+    def _populate_subdiv_so_public_holidays(self):
+        # Law # 64/VI/2005 of May 9th.
+        if self._year >= 2005:
+            # São Lourenço dos Órgãos Municipality Day.
+            self._add_holiday_may_9(tr("Dia do Município de São Lourenço dos Órgãos"))
+
+    def _populate_subdiv_ss_public_holidays(self):
+        # Law # 65/VI/2005 of May 9th.
+        if self._year >= 2005:
+            # São Salvador do Mundo Municipality Day.
+            self._add_holiday_jul_19(tr("Dia do Município de São Salvador do Mundo"))
+
+    def _populate_subdiv_sv_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # São Vicente Municipality Day.
+            self._add_holiday_jan_22(tr("Dia do Município de São Vicente"))
+
+            # Carnival Tuesday.
+            self._add_carnival_tuesday(tr("Terça-feira de Carnaval"))
+
+    def _populate_subdiv_ta_public_holidays(self):
+        # Law # 93/82 of November 6th.
+        if self._year >= 1983:
+            # Tarrafal de Santiago Municipality Day.
+            self._add_holiday_jan_15(tr("Dia do Município do Tarrafal de Santiago"))
+
+    def _populate_subdiv_ts_public_holidays(self):
+        # Law # 67/VI/2005 of May 9th.
+        if self._year >= 2005:
+            # Tarrafal de São Nicolau Municipality Day.
+            self._add_holiday_aug_2(tr("Dia do Município do Tarrafal de São Nicolau"))
+
+
+class CV(CaboVerde):
+    pass
+
+
+class CPV(CaboVerde):
+    pass

holidays/countries/cayman_islands.py

@@ -0,0 +1,162 @@
+#  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: Vacanza Team and individual contributors (see CONTRIBUTORS file)
+#           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/vacanza/holidays
+#  License: MIT (see LICENSE file)
+
+from gettext import gettext as tr
+
+from holidays import APR, MAY, JUN, JUL, SEP, NOV, 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,
+)
+
+
+class CaymanIslands(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
+    """Cayman Islands holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_the_Cayman_Islands>
+        * [Public Holidays Law (2007 Revision)](https://web.archive.org/web/20250227060525/https://legislation.gov.ky/cms/images/LEGISLATION/PRINCIPAL/1964/1964-0140/PublicHolidaysAct_2007%20Revision_g.pdf)
+        * [Public Holidays Order, 2024](https://web.archive.org/web/20240518181823/https://legislation.gov.ky/cms/images/LEGISLATION/AMENDING/2024/2024-O004/PublicHolidaysOrder2024SL4of2024.pdf)
+        * [2006-2015](https://web.archive.org/web/20151014061601/http://www.gov.ky/portal/page?_pageid=1142,1592653&_dad=portal&_schema=PORTAL)
+        * [2016-2018](https://web.archive.org/web/20180330170202/http://www.gov.ky:80/portal/page/portal/cighome/cayman/islands/publicholidays)
+        * [2021](http://archive.today/2025.07.09-033240/https://www.gov.ky/news/press-release-details/public-holidays-for-2021)
+        * [2022](http://archive.today/2025.07.09-033515/https://www.gov.ky/news/press-release-details/public-holidays-2022)
+        * [2024](http://archive.today/2025.01.06-110234/https://www.gov.ky/calendar/public-holidays)
+        * [2025](http://archive.today/2025.07.09-033853/https://www.gov.ky/calendar/public-holidays)
+    """
+
+    country = "KY"
+    default_language = "en_GB"
+    # %s observed.
+    observed_label = tr("%s (observed)")
+    # Earliest year of holidays with an accessible online record.
+    start_year = 2006
+    supported_languages = ("en_GB", "en_US")
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        StaticHolidays.__init__(self, cls=CaymanIslandsStaticHolidays)
+        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_MON)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_observed(self._add_new_years_day(tr("New Year's Day")))
+
+        # National Heroes Day.
+        self._add_holiday_4th_mon_of_jan(tr("National Heroes Day"))
+
+        # Ash Wednesday.
+        self._add_ash_wednesday(tr("Ash Wednesday"))
+
+        # Good Friday.
+        self._add_good_friday(tr("Good Friday"))
+
+        # Easter Monday.
+        self._add_easter_monday(tr("Easter Monday"))
+
+        if self._year >= 2024:
+            # Emancipation Day.
+            self._add_holiday_1st_mon_of_may(tr("Emancipation Day"))
+
+        # Discovery Day.
+        self._add_holiday_3rd_mon_of_may(tr("Discovery Day"))
+
+        if self._year <= 2022:
+            queens_birthday_dates = {
+                2007: (JUN, 18),
+                2012: (JUN, 18),
+                2013: (JUN, 17),
+                2017: (JUN, 19),
+                2022: (JUN, 6),
+            }
+            # Queen's Birthday.
+            name = tr("Queen's Birthday")
+            if dt := queens_birthday_dates.get(self._year):
+                self._add_holiday(name, dt)
+            else:
+                self._add_holiday_2_days_past_2nd_sat_of_jun(name)
+        else:
+            # King's Birthday.
+            self._add_holiday_2_days_past_3rd_sat_of_jun(tr("King's Birthday"))
+
+        # Constitution Day.
+        self._add_holiday_1st_mon_of_jul(tr("Constitution Day"))
+
+        # Remembrance Day.
+        self._add_holiday_2nd_mon_of_nov(tr("Remembrance Day"))
+
+        self._add_observed(
+            # Christmas Day.
+            self._add_christmas_day(tr("Christmas Day")),
+            rule=SAT_SUN_TO_NEXT_MON_TUE,
+        )
+
+        self._add_observed(
+            # Boxing Day.
+            self._add_christmas_day_two(tr("Boxing Day")),
+            rule=SAT_SUN_TO_NEXT_MON_TUE,
+        )
+
+
+class KY(CaymanIslands):
+    pass
+
+
+class CYM(CaymanIslands):
+    pass
+
+
+class CaymanIslandsStaticHolidays:
+    """Cayman Islands special holidays.
+
+    References:
+        * [Public Holidays Order, 2009](https://archive.org/details/public-holidays-order-2009-sl-33-of-2009)
+        * [Public Holidays Order (No. 2), 2019](https://archive.org/details/public-holidays-no.-2-order-2019-sl-38-of-2019)
+        * [Public Holidays Order, 2025](https://archive.org/details/public-holidays-order-2025-sl-15-of-2025)
+        * [Referendum Day 2019](https://web.archive.org/web/20250711121821/https://www.facebook.com/ElectionsOffice/posts/reminder-the-referendum-vote-has-been-postponed-and-will-no-longer-take-place-th/2619995141431734/?_rdc=2&_rdr)
+        * [UK Royal Wedding](https://en.wikipedia.org/wiki/Wedding_of_Prince_William_and_Catherine_Middleton)
+        * [Queen Elizabeth II's Diamond Jubilee](https://web.archive.org/web/20210803202236/https://www.caymancompass.com/2012/06/06/queens-diamond-jubilee-feted/)
+        * [Queen Elizabeth II's Funeral](https://web.archive.org/web/20231226055510/https://www.caymancompass.com/2022/09/12/cayman-declares-public-holiday-for-queens-funeral/)
+        * [King Charles III's Coronation](https://web.archive.org/web/20250601214328/https://www.radiocayman.gov.ky/news/public-holidays-for-2023-unconfirmed)
+    """
+
+    # Referendum Day.
+    referendum_day_name = tr("Referendum Day")
+    # General Election Day.
+    general_election_day_name = tr("General Election Day")
+    special_public_holidays = {
+        2009: (
+            # 2009 Cayman Islands Constitution Day.
+            (NOV, 6, tr("2009 Cayman Islands Constitution Day")),
+            (MAY, 20, general_election_day_name),
+        ),
+        # UK Royal Wedding.
+        2011: (APR, 29, tr("UK Royal Wedding")),
+        2012: (
+            # Queen Elizabeth II's Diamond Jubilee.
+            (JUN, 4, tr("Queen Elizabeth II's Diamond Jubilee")),
+            (JUL, 18, referendum_day_name),
+        ),
+        2013: (MAY, 22, general_election_day_name),
+        2017: (MAY, 24, general_election_day_name),
+        2019: (DEC, 19, referendum_day_name),
+        2021: (APR, 14, general_election_day_name),
+        # Queen Elizabeth II's Funeral.
+        2022: (SEP, 19, tr("Queen Elizabeth II's Funeral")),
+        # King Charles III's Coronation.
+        2023: (MAY, 8, tr("Coronation of His Majesty King Charles III")),
+        2025: (APR, 30, general_election_day_name),
+    }