1.6 KiB
title, description, ha_category, ha_iot_class, ha_release, ha_config_flow, ha_domain, ha_platforms, ha_codeowners, ha_integration_type
| title | description | ha_category | ha_iot_class | ha_release | ha_config_flow | ha_domain | ha_platforms | ha_codeowners | ha_integration_type | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Holiday | Instructions on how to use holiday calendars in Home Assistant. |
|
Local Polling | 2024.1 | true | holiday |
|
|
integration |
The Holiday integration allows you to create a calendar of holidays in Home Assistant for powering automations.
It uses the Python module holidays to incorporate information about region-specific public 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 library. If the country does not support additional categories, the option to configure categories will not be displayed.
{% include integrations/config_flow.md %}
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.