ioBroker.holidays

Tests:

holidays adapter for ioBroker

Shows public, bank, school, optional and observance holidays for all European countries and the most important countries worldwide. Regional rules (federal states, cantons, regions, cities) can be selected. Official holidays can be edited or disabled, and custom holidays can be added — including movable dates such as Easter-based days.

The adapter answers the common automation question: is today a work-free public holiday?

Holiday data is provided by date-holidays (200+ countries, ISO 3166-2 states/regions, Easter/Islamic/Hebrew/Chinese calendars).

Configuration

1. Choose language, country and optionally state / region.
2. Decide what counts as work-free: public holidays always, optionally bank/optional holidays, optionally weekends.
3. Click Load official holidays to edit, rename, retype or disable individual official days.
4. Add custom holidays with a rule, type and work-free flag.
5. Use Preview to check the current year before saving.

Holiday rule examples

| Rule | Meaning | |---|---| | 12-24 | Fixed date, 24 December | | easter | Easter Sunday | | easter -2 | Good Friday | | easter 1 | Easter Monday | | easter 39 | Ascension Day | | 1st monday in May | First Monday in May | | 4th thursday in November | Thanksgiving-style rule |

States

holidays.0
├── info.connection
├── location.{country,countryName,state,stateName,region,regionName,timeZone}
├── today / tomorrow
│   ├── date, weekday
│   ├── isHoliday              any holiday
│   ├── isPublicHoliday        statutory / public
│   ├── isWorkFree             work-free holiday
│   ├── isWeekend
│   ├── isWorkFreeDay          work-free holiday or weekend
│   ├── name, type
│   └── list                   JSON array
├── next.public / next.any     name, date, daysUntil, type
├── lists
│   ├── year
│   ├── all, public, bank, school, optional, observance, workFree, upcoming
│   └── *Text                  human-readable multiline lists
└── commands.refresh

Which list to use

| Need | State | |---|---| | Blockly / scripts, structured data | lists.public, lists.all, today.list (JSON) | | Telegram, VIS text, notifications | lists.publicText, lists.upcomingText | | Next remaining days this year + window | lists.upcoming / lists.upcomingText | | Only days off | lists.workFree / today.isWorkFree | | Presence / heating / alarm scenes | today.isWorkFreeDay | | Countdown widget | next.public.daysUntil |

JSON entries look like { "date", "name", "type", "rule", "workFree", "substitute" }.

Changelog

See CHANGELOG.md.

License

MIT Copyright (c) 2026 Gerhard Steinwedel [email protected]