4.1 KiB
title, description, ha_category, ha_release, ha_quality_scale, ha_codeowners, ha_domain, ha_integration_type
| title | description | ha_category | ha_release | ha_quality_scale | ha_codeowners | ha_domain | ha_integration_type | |||
|---|---|---|---|---|---|---|---|---|---|---|
| Input weekday | Instructions on how to use the input weekday helper with Home Assistant. |
|
2025.11 | internal |
|
input_weekday | helper |
The Input weekday helper integration allows you to define a selection of weekdays that can be controlled via the user interface and used within conditions and triggers of an {% term automation %}. This makes it easy to dynamically manage weekday-based automations without having to manually specify weekdays in your automation configuration.
Configuration
The preferred way to configure input weekday helpers is via the user interface, in which they are known as Weekday Helpers. To add one, go to {% my helpers title="Settings > Devices & services > Helpers" %} and click the add button; next choose the {% my config_flow_start domain="input_weekday" title="Weekday" %} option.
To be able to add Helpers via the user interface you should have
default_config: in your {% term "configuration.yaml" %}, it should already be there by
default unless you removed it. If you removed default_config: from your
configuration, you must add input_weekday: to your {% term "configuration.yaml" %} first,
then you can use the UI.
Input weekdays can also be configured via {% term "configuration.yaml" %} file:
{% configuration %} input_weekday: description: Alias for the input. Multiple entries are allowed. required: true type: map keys: name: description: Friendly name of the input. required: false type: string weekdays: description: List of initially selected weekdays. required: false type: list default: a previous value is restored if available icon: description: Icon to display in front of the input element in the frontend. required: false type: icon {% endconfiguration %}
# Example configuration.yaml entry
input_weekday:
work_days:
name: Work days
weekdays:
- mon
- tue
- wed
- thu
- fri
icon: mdi:briefcase
Valid weekday values are: mon, tue, wed, thu, fri, sat, sun.
Actions
This integration provides the following {% term actions %} to modify the state of the
input_weekday and an action to reload the configuration without restarting
Home Assistant itself.
| Action | Data | Description |
|---|---|---|
set_weekdays |
weekdays |
Set the selected weekdays (replaces all current selections) |
add_weekday |
weekday |
Add a single weekday to the selection |
remove_weekday |
weekday |
Remove a single weekday from the selection |
toggle_weekday |
weekday |
Toggle a single weekday (add if not selected, remove if selected) |
clear |
Clear all selected weekdays | |
reload |
Reload input_weekday configuration |
Automation examples
Here's an example of an automation using the above input_weekday in a time trigger. This automation will only trigger on the selected weekdays.
automation:
alias: "Weekday alarm"
triggers:
- trigger: time
at: "07:00:00"
weekday: input_weekday.work_days
actions:
- action: light.turn_on
target:
entity_id: light.bedroom
You can also use an input_weekday in a time condition:
automation:
alias: "Weekday notifications"
triggers:
- trigger: state
entity_id: binary_sensor.motion_detected
to: "on"
conditions:
- condition: time
weekday: input_weekday.work_days
actions:
- action: notify.mobile_app
data:
message: "Motion detected on a work day"