Holiday
The Holiday integration allows you to create a calendar of holidays in Home Assistant for powering automations.
It uses the Python module holidays
A calendar entity has a state and attributes that represent the next upcoming event (only). A calendar trigger is a much more flexible way to power automations with fewer limitations than using the entity state.
Some countries provides additional categories to be configured besides the public holidays. See the details for each country in the holidays
Configuration
To add the Holiday integration to your Home Assistant instance, use this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Holiday.
-
Follow the instructions on screen to complete the setup.
Holiday calendar automations
Individual holiday Events are what powers automations such as:
- Turn on the Christmas lights at the start of Christmas Day.
- Prevent your covers from being opened on public holidays.
For an overview, refer to calendar automations. You can use calendar trigger variables in a condition or action such as the event summary, description, location and in other places.