{% if prerelease %}
{% endif %}
The holidays componnent is a Home Assistant helper that creates calendar entities with a list of public holidays in a country, based on the Python Holidays library.
It's primary purpose is to work with garbage_collection helper to automatically move entities with manual_update automation blueprints. But it can also be used independently to show next public holiday in given country (or multiple countries).
| Parameter | Required | Description |
|---|---|---|
Country |
Yes | Country holidays - the country code (see holidays for the list of valid country codes). Example: US |
Observed |
No | Observed - when holidays are celebrated on dates that are not the actual event's anniversary date (see holidays ). |
Subdivision |
No | State/Province/District... (see holidays ). |
Pop named holidays |
No | Ignore holidays (select from the list of holiday names) Example: "Columbus Day", "Veterans Day" |
The State contains the number of days to the next country holiday. It is 0 if today is a public holiday.
| Attribute | Description |
|---|---|
next_date |
The date of holiday |
holidays |
List of used country (last year, this year and next year). This is used by the garbage_collection blueprints to offset collections if they fall on a public holiday (or if holiday was earlier on in the week) |
Check the repository for installation instructions.