search

vacanza / holidays

Generate and work with holidays in Python
https://pypi.org/project/holidays
MIT License
1.45k stars 460 forks source link

Document holiday categories #1717

Open arkid15r opened 7 months ago

arkid15r commented 7 months ago

Also, what is the definition and criteria for UNOFFICIAL (this seems to be missing from the documentation as well)? Would National Fruitcake Toss Day be included in this library or not? If so, why?

Originally posted by @mborsetti in https://github.com/vacanza/python-holidays/issues/1669#issuecomment-1977827253

We should add a section explaining each holiday category purpose with holiday examples (ideally multiple entities holidays would be included).

arkid15r commented 7 months ago

@mborsetti please feel free to add/correct the description in case I'm missing something.

PPsyrius commented 7 months ago

We can probably start with PUBLIC ones, which are officially recognized holidays that applies to everyone in a particular jurisdiction.

WORKDAY on the other hand are observed by that jurisdiction's government but no holidays are given. Example for this would be United States' "Cinco de Mayo" due to its US Congress concurrent resolution status or Thailand's "Teachers' Day" as per gazetted back in 1956.

UNOFFICIAL would be those which are commonly celebrated by citizens of a particular jurisdiction but with no official observance - example of this would be Halloweens and Valentine's Day in the United States.