# ItalianHolidays
A simple Python helper class to determine Italian holidays with the possibility to set custom holidays. Easter holidays' calculation will work for dates between 1900-2199.
[](https://pypi.python.org/pypi/italian-holidays/)
[](https://pypi.python.org/pypi/italian-holidays/)
[](https://pypi.python.org/pypi/italian-holidays/)
[](https://pypi.python.org/pypi/italian-holidays/)
[](https://github.com/giuseppebruno/italian-holidays/blob/master/LICENSE)
## Install
### Using Pip
```bash
pip install italian-holidays
```
## Usage
```python
from italian_holidays import italian_holidays
from datetime import datetime
custom_holidays = ["01-03", "01-05"] # date format: month-day | in this example: 3 January, 5 January
# But accepts also array of datetime object
custom_holidays = [datetime(2021, 1, 3), datetime(2021, 1, 5)]
holidays = italian_holidays(custom_holidays) # or simply italian_holidays() if you have no custom holidays to set
# Passing string
is_holiday = holidays.is_holiday("2024-01-03")
print(is_holiday) # True
# Passing datetime object
day = datetime(2031, 4, 14)
is_holiday = holidays.is_holiday(day)
print(is_holiday) # True
# Getting holiday's name (return None if date is not an italian holiday, return 'Custom holiday' if is one of the given dates)
holiday_name = holidays.holiday_name("2020-11-01")
print(holiday_name) # All Saints' Day
```
## Licence
Source code can be found on [github](https://github.com/giuseppebruno/italian-holidays), licenced under [MIT](http://opensource.org/licenses/mit-license.php).
Developed by [Giuseppe Bruno](https://gbrunodev.it)
Raw data
{
"_id": null,
"home_page": "https://github.com/giuseppebruno/italian-holidays",
"name": "italian-holidays",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": null,
"keywords": "italian, holidays",
"author": "Giuseppe Bruno",
"author_email": "Giuseppe Bruno <info@gbrunodev.it>",
"download_url": "https://files.pythonhosted.org/packages/b7/b5/5f34a3f8ab149eb6ef0033a28194a459735b9d5dfe12d14d9b695e38a577/italian_holidays-0.0.7.tar.gz",
"platform": null,
"description": "# ItalianHolidays\n\nA simple Python helper class to determine Italian holidays with the possibility to set custom holidays. Easter holidays' calculation will work for dates between 1900-2199.\n\n[](https://pypi.python.org/pypi/italian-holidays/)\n[](https://pypi.python.org/pypi/italian-holidays/)\n[](https://pypi.python.org/pypi/italian-holidays/)\n[](https://pypi.python.org/pypi/italian-holidays/)\n[](https://github.com/giuseppebruno/italian-holidays/blob/master/LICENSE)\n\n## Install\n\n### Using Pip\n\n```bash\npip install italian-holidays\n```\n\n## Usage\n\n```python\nfrom italian_holidays import italian_holidays\nfrom datetime import datetime\n\ncustom_holidays = [\"01-03\", \"01-05\"] # date format: month-day | in this example: 3 January, 5 January\n\n# But accepts also array of datetime object\ncustom_holidays = [datetime(2021, 1, 3), datetime(2021, 1, 5)]\n\nholidays = italian_holidays(custom_holidays) # or simply italian_holidays() if you have no custom holidays to set\n\n# Passing string\nis_holiday = holidays.is_holiday(\"2024-01-03\")\nprint(is_holiday) # True\n\n# Passing datetime object\nday = datetime(2031, 4, 14)\nis_holiday = holidays.is_holiday(day)\nprint(is_holiday) # True\n\n# Getting holiday's name (return None if date is not an italian holiday, return 'Custom holiday' if is one of the given dates)\nholiday_name = holidays.holiday_name(\"2020-11-01\")\nprint(holiday_name) # All Saints' Day\n```\n\n## Licence\n\nSource code can be found on [github](https://github.com/giuseppebruno/italian-holidays), licenced under [MIT](http://opensource.org/licenses/mit-license.php).\n\nDeveloped by [Giuseppe Bruno](https://gbrunodev.it)\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "A simple Python helper class to determine Italian holidays with the possibility to set custom holidays.",
"version": "0.0.7",
"project_urls": {
"Homepage": "https://github.com/giuseppebruno/italian-holidays"
},
"split_keywords": [
"italian",
" holidays"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "31e07b297cb13951ca6365b3da1c4772c7e47d2fbeaa6286aa9ea8704c13cc3c",
"md5": "be86f6c481b7230b883dcce7ab6b64ba",
"sha256": "51bcf358fa0d4bd1a5b5604ceb709f179eeaf09ce368e2315f8ae4ed3f23fc2d"
},
"downloads": -1,
"filename": "italian_holidays-0.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "be86f6c481b7230b883dcce7ab6b64ba",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 4396,
"upload_time": "2025-08-26T16:28:45",
"upload_time_iso_8601": "2025-08-26T16:28:45.280977Z",
"url": "https://files.pythonhosted.org/packages/31/e0/7b297cb13951ca6365b3da1c4772c7e47d2fbeaa6286aa9ea8704c13cc3c/italian_holidays-0.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b7b55f34a3f8ab149eb6ef0033a28194a459735b9d5dfe12d14d9b695e38a577",
"md5": "dc79d85df334cd345614eabc5b8a9d42",
"sha256": "08a4b8701df882e17fc54a7544e2cc513f95e8e32ef5b82fde3d6adc0e23c308"
},
"downloads": -1,
"filename": "italian_holidays-0.0.7.tar.gz",
"has_sig": false,
"md5_digest": "dc79d85df334cd345614eabc5b8a9d42",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 4219,
"upload_time": "2025-08-26T16:28:47",
"upload_time_iso_8601": "2025-08-26T16:28:47.246320Z",
"url": "https://files.pythonhosted.org/packages/b7/b5/5f34a3f8ab149eb6ef0033a28194a459735b9d5dfe12d14d9b695e38a577/italian_holidays-0.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-26 16:28:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "giuseppebruno",
"github_project": "italian-holidays",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "italian-holidays"
}
JSON
