ilgaz/Time-Series-Analysis
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
5d3c35492d30d26d51b1aa8d7c4a7ebff6b61b34
Time-Series-Analysis/venv/lib/python3.11/site-packages/holidays/countries/timor_leste.py
root 5d3c35492d reconnect moved files to git repo
2025-08-01 04:33:03 -04:00

510 lines
24 KiB
Python
Raw Blame History

# 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.calendars import _CustomIslamicHolidays
from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
from holidays.constants import GOVERNMENT, PUBLIC, WORKDAY
from holidays.groups import (
ChristianHolidays,
InternationalHolidays,
IslamicHolidays,
StaticHolidays,
)
from holidays.holiday_base import HolidayBase
class TimorLeste(
HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays, StaticHolidays
):
"""Timor Leste holidays.
References:
* [2005 Law](https://web.archive.org/web/20240813193212/https://mj.gov.tl/jornal/lawsTL/RDTL-Law/RDTL-Laws/Law-2005-10.pdf)
* [2016 Amendment](https://web.archive.org/web/20250414152148/https://timor-leste.gov.tl/?p=14494&lang=en)
* [2022](https://web.archive.org/web/20240802065911/https://timor-leste.gov.tl/?p=30266&lang=en)
* [2023 (en_US)](https://web.archive.org/web/20250414071435/https://timor-leste.gov.tl/?lang=en&p=31750)
* [2023 (pt_PT)](https://web.archive.org/web/20250416013718/https://timor-leste.gov.tl/?lang=pt&p=31750)
* [2023 (tet)](https://web.archive.org/web/20250415232148/https://timor-leste.gov.tl/?p=31750&lang=tp)
* [2024](https://web.archive.org/web/20250421164147/https://timor-leste.gov.tl/?p=35833&lang=en)
* [2025](https://web.archive.org/web/20250416022640/https://timor-leste.gov.tl/?lang=en&p=41492)
Limitations:
* Exact Islamic holidays dates are only available for 2011-2025; the rest are estimates.
"""
country = "TL"
supported_categories = (GOVERNMENT, PUBLIC, WORKDAY)
default_language = "pt_TL"
# %s (estimated).
estimated_label = tr("%s (aproximada)")
supported_languages = ("en_TL", "en_US", "pt_TL", "tet", "th")
# Law No. 10/2005 Of 10 August, Public Holidays and Official Commemorative Dates.
start_year = 2006
def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
"""
Args:
islamic_show_estimated:
Whether to add "estimated" label to Islamic holidays name
if holiday date is estimated.
"""
ChristianHolidays.__init__(self)
InternationalHolidays.__init__(self)
IslamicHolidays.__init__(
self, cls=TimorLesteIslamicHolidays, show_estimated=islamic_show_estimated
)
StaticHolidays.__init__(self, TimorLesteStaticHolidays)
super().__init__(*args, **kwargs)
def _populate_public_holidays(self):
# Fixed Date Public Holidays.
# New Year's Day.
self._add_new_years_day(tr("Dia de Ano Novo"))
# Dia dos Veteranos.
# First appeared in 2017.
if self._year >= 2017:
# Veteran's Day.
self._add_holiday_mar_3(tr("Dia dos Veteranos"))
# International Worker's Day.
self._add_labor_day(tr("Dia Mundial do Trabalhador"))
# Restoration of Independence Day.
self._add_holiday_may_20(tr("Dia da Restauração da Independência"))
# Popular Consultation Day.
self._add_holiday_aug_30(tr("Dia da Consulta Popular"))
# All Saints' Day.
self._add_all_saints_day(tr("Dia de Todos os Santos"))
# All Souls' Day.
self._add_all_souls_day(tr("Dia de Todos os Fiéis Defuntos"))
# Dia Nacional da Mulher.
# Originally classed as "Commemorative Date" only, reclassified in 2023.
if self._year >= 2023:
# National Women's Day.
self._add_holiday_nov_3(tr("Dia Nacional da Mulher"))
# National Youth Day.
self._add_holiday_nov_12(tr("Dia Nacional da Juventude"))
# Proclamation of Independence Day.
self._add_holiday_nov_28(tr("Dia da Proclamação da Independência"))
# Dia da Memória
# Created to replaced the original National Heroes Day in 2017.
if self._year >= 2017:
# Memorial Day.
self._add_holiday_dec_7(tr("Dia da Memória"))
self._add_immaculate_conception_day(
# Day of Our Lady of Immaculate Conception and Timor-Leste Patroness.
tr("Dia de Nossa Senhora da Imaculada Conceição, padroeira de Timor-Leste")
)
# Christmas Day.
self._add_christmas_day(tr("Dia de Natal"))
# Dia dos Heróis Nacionais.
# Moved to Dec 31 in 2017.
# National Heroes Day.
name = tr("Dia dos Heróis Nacionais")
if self._year >= 2017:
self._add_holiday_dec_31(name)
else:
self._add_holiday_dec_7(name)
# Variable Date Public Holidays.
# Holy Friday.
self._add_good_friday(tr("Sexta-Feira Santa"))
# Eid al-Fitr.
self._add_eid_al_fitr_day(tr("Idul Fitri"))
# Corpus Christi.
self._add_corpus_christi_day(tr("Festa do Corpo de Deus"))
# Eid al-Adha.
self._add_eid_al_adha_day(tr("Idul Adha"))
def _populate_workday_holidays(self):
# Fixed Date Government Holidays.
# International Children's Day.
self._add_childrens_day(tr("Dia Mundial da Criança"))
self._add_holiday_aug_20(
# Day of the Armed Forces for the National Liberation of Timor-Leste (FALINTIL).
tr("Dia das Forças Armadas de Libertação Nacional de Timor-Leste (FALINTIL)")
)
# Dia Nacional da Mulher.
# Originally classed as "Commemorative Date" only, reclassified in 2023.
# Prior to reclassification, this is usually only observed as half-day holiday. i.e.
# 2010:
# https://web.archive.org/web/20250427130447/https://timor-leste.gov.tl/?p=4183&lang=en
# 2011:
# https://web.archive.org/web/20250414065353/https://timor-leste.gov.tl/?p=5979&lang=en
if self._year <= 2022:
# National Women's Day.
self._add_holiday_nov_3(tr("Dia Nacional da Mulher"))
# International Human Rights Day.
self._add_holiday_dec_10(tr("Dia Mundial dos Direitos Humanos"))
# Variable Date Government Holidays.
# Ash Wednesday.
self._add_ash_wednesday(tr("Quarta-Feira de Cinzas"))
# Holy Thursday.
self._add_holy_thursday(tr("Quinta-Feira Santa"))
# The Day of Ascension of Jesus Christ into Heaven.
self._add_ascension_thursday(tr("Dia da Ascensão de Jesus Cristo ao Céu"))
class TL(TimorLeste):
pass
class TLS(TimorLeste):
pass
class TimorLesteIslamicHolidays(_CustomIslamicHolidays):
EID_AL_ADHA_DATES = {
2011: (NOV, 7),
2012: (OCT, 26),
2013: (OCT, 15),
2014: (OCT, 4),
2015: (SEP, 24),
2016: (SEP, 18),
2017: (SEP, 1),
2018: (AUG, 21),
2019: (AUG, 11),
2020: (JUL, 31),
2021: (JUL, 19),
2022: (JUL, 9),
2023: (JUN, 29),
2024: (JUN, 17),
2025: (JUN, 6),
}
EID_AL_FITR_DATES = {
2011: (AUG, 31),
2012: (AUG, 20),
2013: (AUG, 8),
2014: (JUL, 28),
2015: (JUL, 17),
2016: (JUL, 7),
2017: (JUN, 26),
2018: (JUN, 15),
2019: (JUN, 6),
2020: (MAY, 24),
2021: (MAY, 13),
2022: (MAY, 2),
2023: (APR, 22),
2024: (APR, 10),
2025: (MAR, 31),
}
class TimorLesteStaticHolidays:
# Special Holidays.
# National Holidays (Special).
special_national_holidays = tr("Feriados Nacionais (Especiais)")
# Presidential Election Day.
presidential_election = tr("Dia da Eleição Presidencial")
# Parliamentary Election Day.
parliamentary_election = tr("Dia de Eleições Parlamentares")
# Local Election Day.
local_election = tr("Dia de eleições locais")
# Centenary of the Revolt of Dom Boaventura.
dom_boaventura_centenary = tr("Centenário da Revolta de Dom Boaventura")
# Funeral Ceremonies of Fernando 'La Sama' de Araújo.
la_sama_funeral = tr("Cerimónias Fúnebres de Fernando 'La Sama' de Araújo")
# 20th Anniversary Celebrations of the Popular Consultation.
popular_consultation_20th = tr("Celebrações do 20.º Aniversário da Consulta Popular")
# 25th Anniversary Celebrations of the Popular Consultation.
popular_consultation_25th = tr("Celebrações do 25.º Aniversário da Consulta Popular")
# Visit of His Holiness Pope Francis to Timor-Leste.
pope_francis_visit = tr("Visita de Sua Santidade o Papa Francisco a Timor-Leste")
special_government_holidays = {
2010: (
# https://web.archive.org/web/20250427130447/https://timor-leste.gov.tl/?p=4183&lang=en
(NOV, 3, special_national_holidays),
# https://web.archive.org/web/20250414065444/https://timor-leste.gov.tl/?p=4437&lang=en
(DEC, 24, special_national_holidays),
(DEC, 31, special_national_holidays),
),
2011: (
# https://web.archive.org/web/20250414065414/https://timor-leste.gov.tl/?p=5496&lang=en
(AUG, 15, special_national_holidays),
# https://web.archive.org/web/20250414065353/https://timor-leste.gov.tl/?p=5979&lang=en
(NOV, 3, special_national_holidays),
# https://web.archive.org/web/20250427130448/https://timor-leste.gov.tl/?p=6264&lang=en
(DEC, 26, special_national_holidays),
),
2012: (
# https://web.archive.org/web/20250427130448/https://timor-leste.gov.tl/?p=6264&lang=en
(JAN, 2, special_national_holidays),
# https://web.archive.org/web/20250414065422/https://timor-leste.gov.tl/?p=6347&lang=en
(JAN, 23, special_national_holidays),
# https://web.archive.org/web/20250414065452/https://timor-leste.gov.tl/?p=6471&lang=en
(FEB, 22, special_national_holidays),
# https://web.archive.org/web/20250427130503/https://timor-leste.gov.tl/?p=6621&lang=en
(MAR, 16, presidential_election),
# https://web.archive.org/web/20250414065432/https://timor-leste.gov.tl/?p=6760&lang=en
(APR, 16, presidential_election),
(APR, 17, presidential_election),
# https://web.archive.org/web/20250427130515/https://timor-leste.gov.tl/?p=7035&lang=en
(JUL, 6, parliamentary_election),
# https://web.archive.org/web/20250427130516/https://timor-leste.gov.tl/?p=7046&lang=en
(JUL, 9, parliamentary_election),
# https://web.archive.org/web/20250414065639/https://timor-leste.gov.tl/?p=7474&lang=en
(NOV, 27, dom_boaventura_centenary),
(NOV, 29, dom_boaventura_centenary),
# https://web.archive.org/web/20250414065642/http://timor-leste.gov.tl/?p=7550&lang=en
(DEC, 24, special_national_holidays),
(DEC, 26, special_national_holidays),
(DEC, 31, special_national_holidays),
),
2013: (
# https://web.archive.org/web/20250427130528/https://timor-leste.gov.tl/?p=7715&lang=en
(FEB, 13, special_national_holidays),
# https://web.archive.org/web/20250427130538/https://timor-leste.gov.tl/?p=7918&lang=en
(MAR, 28, special_national_holidays),
(APR, 1, special_national_holidays),
# https://web.archive.org/web/20250414065612/https://timor-leste.gov.tl/?p=8664&lang=en
(AUG, 20, special_national_holidays),
# https://web.archive.org/web/20250414065748/https://timor-leste.gov.tl/?p=9392&lang=en
(NOV, 29, special_national_holidays),
# https://web.archive.org/web/20250414065744/http://timor-leste.gov.tl/?p=9475&lang=en
(DEC, 24, special_national_holidays),
(DEC, 26, special_national_holidays),
(DEC, 31, special_national_holidays),
),
2014: (
# https://web.archive.org/web/20250427130548/https://timor-leste.gov.tl/?p=9759&lang=en
(MAR, 5, special_national_holidays),
# https://web.archive.org/web/20210826174115/http://timor-leste.gov.tl/?p=9964&lang=en
(APR, 17, special_national_holidays),
(APR, 21, special_national_holidays),
# https://web.archive.org/web/20250427130153/http://timor-leste.gov.tl/?p=10294&lang=en
(JUL, 22, special_national_holidays),
(JUL, 23, special_national_holidays),
# https://web.archive.org/web/20250414065707/https://timor-leste.gov.tl/?p=10524&lang=en
(AUG, 15, special_national_holidays),
(AUG, 20, special_national_holidays),
# https://web.archive.org/web/20250427130202/https://timor-leste.gov.tl/?p=11036&lang=en
(DEC, 24, special_national_holidays),
(DEC, 26, special_national_holidays),
(DEC, 31, special_national_holidays),
),
2015: (
# https://web.archive.org/web/20250427130202/https://timor-leste.gov.tl/?p=11036&lang=en
(JAN, 2, special_national_holidays),
# https://web.archive.org/web/20250414065729/https://timor-leste.gov.tl/?p=11247&lang=en
(FEB, 18, special_national_holidays),
# https://web.archive.org/web/20250414065741/https://timor-leste.gov.tl/?p=11544&lang=en
(APR, 2, special_national_holidays),
# https://web.archive.org/web/20250414065752/https://timor-leste.gov.tl/?p=11966&lang=en
(MAY, 13, special_national_holidays),
# https://web.archive.org/web/20230624130431/http://timor-leste.gov.tl/?p=12246&lang=en
(JUN, 5, la_sama_funeral),
# https://web.archive.org/web/20250414065950/https://timor-leste.gov.tl/?p=13105&lang=en
(AUG, 20, special_national_holidays),
# https://web.archive.org/web/20250414065829/https://timor-leste.gov.tl/?p=14271&lang=en
(DEC, 24, special_national_holidays),
(DEC, 31, special_national_holidays),
),
2016: (
# https://web.archive.org/web/20240816060741/https://timor-leste.gov.tl/?p=14482&lang=en
(FEB, 10, special_national_holidays),
# https://web.archive.org/web/20250414070020/https://timor-leste.gov.tl/?p=14827&lang=en
(MAR, 24, special_national_holidays),
# https://web.archive.org/web/20250414065859/https://timor-leste.gov.tl/?p=15740&lang=en
(JUL, 6, special_national_holidays),
# https://web.archive.org/web/20250414070052/https://timor-leste.gov.tl/?p=16626&lang=en
(NOV, 3, special_national_holidays),
# https://web.archive.org/web/20250427130231/https://timor-leste.gov.tl/?p=16998&lang=en
(DEC, 26, special_national_holidays),
),
2017: (
# https://web.archive.org/web/20250427130231/https://timor-leste.gov.tl/?p=16998&lang=en
(JAN, 2, special_national_holidays),
# https://web.archive.org/web/20250427130238/https://timor-leste.gov.tl/?p=17428&lang=en
(MAR, 1, special_national_holidays),
# https://web.archive.org/web/20250427130247/https://timor-leste.gov.tl/?p=17548&lang=en
(MAR, 20, presidential_election),
(MAR, 21, presidential_election),
# https://web.archive.org/web/20250414070116/https://timor-leste.gov.tl/?p=17698&lang=en
(APR, 13, special_national_holidays),
# https://web.archive.org/web/20250427130254/https://timor-leste.gov.tl/?p=19189&lang=en
(DEC, 26, special_national_holidays),
),
2018: (
# https://web.archive.org/web/20250427130254/https://timor-leste.gov.tl/?p=19189&lang=en
(JAN, 2, special_national_holidays),
# https://web.archive.org/web/20240813145627/https://timor-leste.gov.tl/?p=19411&lang=en
(FEB, 14, special_national_holidays),
# https://web.archive.org/web/20250414070149/https://timor-leste.gov.tl/?p=19452&lang=en
(FEB, 16, special_national_holidays),
# https://web.archive.org/web/20240813145438/https://timor-leste.gov.tl/?p=19693&lang=en
(MAR, 29, special_national_holidays),
# https://web.archive.org/web/20250414070232/https://timor-leste.gov.tl/?p=20199&lang=en
(AUG, 22, special_national_holidays),
),
2019: (
# https://web.archive.org/web/20250414070216/https://timor-leste.gov.tl/?p=21116&lang=en
(FEB, 5, special_national_holidays),
# https://web.archive.org/web/20250414070241/https://timor-leste.gov.tl/?p=21207&lang=en
(MAR, 6, special_national_holidays),
# https://web.archive.org/web/20240812151629/https://timor-leste.gov.tl/?p=21607&lang=en
(APR, 18, special_national_holidays),
# https://web.archive.org/web/20250427130325/https://timor-leste.gov.tl/?p=22642&lang=en
(AUG, 12, special_national_holidays),
# https://web.archive.org/web/20250414070318/https://timor-leste.gov.tl/?p=22681&lang=en
(AUG, 20, special_national_holidays),
# https://web.archive.org/web/20240812044011/https://timor-leste.gov.tl/?p=22701&lang=en
(AUG, 26, popular_consultation_20th),
(AUG, 27, popular_consultation_20th),
(AUG, 28, popular_consultation_20th),
(AUG, 29, popular_consultation_20th),
# https://web.archive.org/web/20250414070227/https://timor-leste.gov.tl/?p=23277&lang=en
(OCT, 31, special_national_holidays),
# https://web.archive.org/web/20250414070409/https://timor-leste.gov.tl/?p=23417&lang=en
(DEC, 24, special_national_holidays),
(DEC, 26, special_national_holidays),
(DEC, 30, special_national_holidays),
),
2020: (
# https://web.archive.org/web/20250414070409/https://timor-leste.gov.tl/?p=23417&lang=en
(JAN, 2, special_national_holidays),
# https://web.archive.org/web/20250427130330/https://timor-leste.gov.tl/?p=23607&lang=en
(FEB, 26, special_national_holidays),
# https://web.archive.org/web/20250427130347/https://timor-leste.gov.tl/?p=25455&lang=en
(AUG, 20, special_national_holidays),
# https://web.archive.org/web/20250414070335/https://timor-leste.gov.tl/?p=25502&lang=en
(AUG, 31, special_national_holidays),
# https://web.archive.org/web/20250414070433/https://timor-leste.gov.tl/?p=26030&lang=en
(NOV, 3, special_national_holidays),
# https://web.archive.org/web/20250427130521/https://timor-leste.gov.tl/?p=26365&lang=en
(DEC, 24, special_national_holidays),
),
2021: (
# https://web.archive.org/web/20250414070431/https://timor-leste.gov.tl/?p=26865&lang=en
(FEB, 12, special_national_holidays),
# https://web.archive.org/web/20250414070435/https://timor-leste.gov.tl/?p=26896&lang=en
(FEB, 17, special_national_holidays),
# https://web.archive.org/web/20250414070527/https://timor-leste.gov.tl/?p=29682&lang=en
(NOV, 3, special_national_holidays),
),
2022: (
# https://web.archive.org/web/20250414070535/https://timor-leste.gov.tl/?p=30029&lang=en
(FEB, 1, special_national_holidays),
# https://web.archive.org/web/20250414070533/https://timor-leste.gov.tl/?p=30194&lang=en
(MAR, 2, special_national_holidays),
# https://web.archive.org/web/20250414070535/https://timor-leste.gov.tl/?p=30254&lang=en
(MAR, 18, presidential_election),
# https://web.archive.org/web/20250414070614/https://timor-leste.gov.tl/?p=30429&lang=en
(APR, 14, special_national_holidays),
(APR, 18, presidential_election),
(APR, 19, presidential_election),
(APR, 20, presidential_election),
# https://web.archive.org/web/20250414070557/https://timor-leste.gov.tl/?p=31107&lang=en
(AUG, 29, special_national_holidays),
# https://web.archive.org/web/20250414070537/https://timor-leste.gov.tl/?p=31152&lang=en
(SEP, 6, special_national_holidays),
# https://web.archive.org/web/20250414070629/https://timor-leste.gov.tl/?p=31404&lang=en
(OCT, 31, special_national_holidays),
# https://web.archive.org/web/20250427130438/https://timor-leste.gov.tl/?p=31574&lang=en
(DEC, 9, special_national_holidays),
# https://web.archive.org/web/20250414070644/https://timor-leste.gov.tl/?p=31633&lang=en
(DEC, 26, special_national_holidays),
),
2023: (
# https://web.archive.org/web/20250414070658/https://timor-leste.gov.tl/?p=31641&lang=en
(JAN, 2, special_national_holidays),
# https://web.archive.org/web/20250414070652/https://timor-leste.gov.tl/?p=31798&lang=en
(JAN, 23, special_national_holidays),
# https://web.archive.org/web/20250414070730/https://timor-leste.gov.tl/?p=32191&lang=en
(FEB, 22, special_national_holidays),
# https://web.archive.org/web/20250414070922/https://timor-leste.gov.tl/?p=32561&lang=en
(APR, 6, special_national_holidays),
(APR, 10, special_national_holidays),
# https://web.archive.org/web/20250414070723/https://timor-leste.gov.tl/?p=32590&lang=en
(APR, 20, special_national_holidays),
(APR, 21, special_national_holidays),
# https://web.archive.org/web/20250414070814/https://timor-leste.gov.tl/?p=32617&lang=en
(MAY, 19, parliamentary_election),
(MAY, 22, parliamentary_election),
# https://web.archive.org/web/20250414035027/https://timor-leste.gov.tl/?p=34792&lang=en
(OCT, 27, local_election),
# https://web.archive.org/web/20250414070835/https://timor-leste.gov.tl/?p=35060&lang=en
(NOV, 13, local_election),
# https://web.archive.org/web/20250429134659/https://timor-leste.gov.tl/?p=35627&lang=en&
(DEC, 26, special_national_holidays),
),
2024: (
# https://web.archive.org/web/20250417085916/https://timor-leste.gov.tl/?p=35627&lang=en
(JAN, 2, special_national_holidays),
# https://web.archive.org/web/20250414070914/https://timor-leste.gov.tl/?p=36002&lang=en
(FEB, 14, special_national_holidays),
# https://web.archive.org/web/20250420193703/https://timor-leste.gov.tl/?p=36859&lang=en
(MAR, 28, special_national_holidays),
# https://web.archive.org/web/20250414121144/https://timor-leste.gov.tl/?p=39062&lang=en
(AUG, 28, popular_consultation_25th),
(AUG, 29, popular_consultation_25th),
# https://web.archive.org/web/20250414070900/https://timor-leste.gov.tl/?p=39068&lang=en
(SEP, 9, pope_francis_visit),
(SEP, 10, pope_francis_visit),
(SEP, 11, pope_francis_visit),
# https://web.archive.org/web/20250421064400/https://timor-leste.gov.tl/?p=40592&lang=en
(OCT, 31, special_national_holidays),
# https://web.archive.org/web/20250414071012/https://timor-leste.gov.tl/?p=40955&lang=en
(NOV, 29, special_national_holidays),
# https://web.archive.org/web/20250414071025/https://timor-leste.gov.tl/?p=41325&lang=en
(DEC, 24, special_national_holidays),
),
2025: (
# https://web.archive.org/web/20250414070915/https://timor-leste.gov.tl/?p=41361&lang=en
(JAN, 2, special_national_holidays),
# https://web.archive.org/web/20250414070923/https://timor-leste.gov.tl/?p=41592&lang=en
(JAN, 29, special_national_holidays),
# https://web.archive.org/web/20250414070934/https://timor-leste.gov.tl/?p=42076&lang=en
(MAR, 5, special_national_holidays),
),
}
Reference in New Issue View Git Blame Copy Permalink