36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
---
|
|
title: Holiday
|
|
description: Instructions on how to use holiday calendars in Home Assistant.
|
|
ha_category:
|
|
- Calendar
|
|
ha_iot_class: Local Polling
|
|
ha_release: 2024.1
|
|
ha_config_flow: true
|
|
ha_domain: holiday
|
|
ha_platforms:
|
|
- calendar
|
|
ha_codeowners:
|
|
- '@jrieger'
|
|
- '@gjohansson-ST'
|
|
ha_integration_type: integration
|
|
---
|
|
|
|
The Holiday integration allows you to create a calendar of holidays in Home Assistant for powering automations.
|
|
|
|
It uses the Python module [holidays](https://pypi.org/project/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](https://pypi.org/project/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](/integrations/calendar#automation). You can use [calendar trigger variables](/docs/automation/templating/#calendar) in a condition or action such as the event `summary`, `description`, `location` and in other places.
|