About
Workday is a built-in Home Assistant integration that tells whether a day counts as a workday. It adds a binary sensor and a calendar, and runs locally. Workdays depend on the chosen country, with an optional subdivision such as a state or region, and the language used for named holidays can be set. Weekdays can be included or excluded, custom holidays can be added as dates or ranges, and holidays can be removed by date or by part of a name. An offset in days shifts the day being checked, and an extra category of holidays can be counted. A check date action tests whether a given date is a workday, and setup is done in the UI.
Automatic summary of Home Assistant's source code. Something wrong? Get in touch
Supports
Works locally Talks to your devices on your own network. No vendor cloud in between.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Updated with Home Assistant Ships and updates with every Home Assistant release.
Provides
- Calendars
Setting it up
It is added under Settings, Devices and services, with Add integration.
Connect
- Country
- Name
Options
- Add holidaysAdd custom holidays as YYYY-MM-DD or as range using , as separator
- Additional category as holidaySelect additional categories to include as holidays
- OffsetDays offset from current day
- Days to excludeSelect which weekdays to exclude as workdays. The key holidays adds those for the configured country, customizable by all the settings below. Read the documentation on how to use them correctly.
- Language for named holidaysLanguage to use when configuring named holiday exclusions
- Subdivision of countryState, territory, province or region of country
- Remove holidaysRemove holidays as YYYY-MM-DD, as range using , as separator or by using partial of name
- Days to includeSelect which weekdays to include as possible workdays.
After setup
- Add holidaysAdd custom holidays as YYYY-MM-DD or as range using , as separator
- Additional category as holidaySelect additional categories to include as holidays
- OffsetDays offset from current day
- Days to excludeSelect which weekdays to exclude as workdays. The key holidays adds those for the configured country, customizable by all the settings below. Read the documentation on how to use them correctly.
- Language for named holidaysLanguage to use when configuring named holiday exclusions
- Subdivision of countryState, territory, province or region of country
- Remove holidaysRemove holidays as YYYY-MM-DD, as range using , as separator or by using partial of name
- Days to includeSelect which weekdays to include as possible workdays.
Texts from Home Assistant's source code, Apache License 2.0.
Entities
- CalendarsCalendar
Actions
- Check dateChecks if a given date is a workday.Fields: Date
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
Shows in Vulpo
Calendar card, Apple Watch.Information
- Installs
- 30.1k sharing analytics
- Connection
- Works locally
- Upkeep
- Part of Home Assistant
- Category
- Productivity and information, Calendars and to-dos
- Kind
- Built-in integration
- Needs
- Built into Home Assistant
- Domain
workday











