Time entity: add state (#34796)

This commit is contained in:
c0ffeeca7 2024-09-18 10:02:00 +02:00 committed by GitHub
parent bde967fc19
commit d4775e7ce3
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 14 additions and 5 deletions

View File

@ -11,12 +11,21 @@ ha_codeowners:
ha_integration_type: entity
---
The Time integration is built for the controlling and monitoring of times on devices.
The **Time** {% term integration %} is built for controlling and monitoring times on devices.
{% include integrations/building_block_integration.md %}
If you are looking for a way to create a similar entity, please take a look at the [Date/Time helper](/integrations/input_datetime).
## The state of a time entity
The state of a time {% term entity %} is a timestamp in the format HH:MM:SS.
<p class='img'>
<img src='/images/integrations/time/state_time.png' alt='Screenshot showing the state of a time entity in the developer tools' />
Screenshot showing the state of a time entity in the developer tools.
</p>
## Actions
### Time actions
@ -27,7 +36,7 @@ Available actions: `time.set_value`
Set a new value for the time entity.
| Data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | no | String or list of strings that point at `entity_id`'s of times to control.
| `time` | no | New time value to set.
| Data attribute | Optional | Description |
| -------------- | -------- | -------------------------------------------------------------------------- |
| `entity_id` | no | String or list of strings that point at `entity_id`'s of times to control. |
| `time` | no | New time value to set. |

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB