jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-17 14:26:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Datetime: add state (#34686)

Browse Source
This commit is contained in:
c0ffeeca7 2024-09-11 15:31:52 +02:00 committed by GitHub
parent 35dc147d7e
commit 672fd7865a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 12 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
source/_integrations/datetime.markdown
View File

@ -17,6 +17,15 @@ The **Date/Time** {% term integration %} is built for the controlling and monito
If you are looking for a way to create a Date/Time entity, please take a look at the [Date/Time helper](/integrations/input_datetime). If you are looking for a way to create a Date/Time entity, please take a look at the [Date/Time helper](/integrations/input_datetime).
## The state of a date/time entity
The state of a date/time entity is the actual date and time value.
<p class='img'>
<img src='/images/integrations/datetime/state_datetime.png' alt='Screenshot showing the state of a date/time entity in the developer tools' />
Screenshot showing the state of a date/time entity in the developer tools. In the example shown, the state is January 1, 2020 at 12:00 in the format YYYY-MM-DD T HH:MM:SS.
</p>
## Actions ## Actions
### datetime actions ### datetime actions
@ -28,6 +37,6 @@ Available {% term actions %}: `datetime.set_value`
Set a new value for the datetime {% term entity %}. Set a new value for the datetime {% term entity %}.
| Data attribute | Optional | Description | | Data attribute | Optional | Description |
| ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------ | | -------------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| `entity_id` | no | String or list of strings that point at `entity_id`'s of datetimes to control. | | `entity_id` | no | String or list of strings that point at `entity_id`'s of datetimes to control. |
| `datetime` | no | New datetime value to set. If timezone is not included, the Home Assistant instance's timezone will be used. | | `datetime` | no | New datetime value to set. If timezone is not included, the Home Assistant instance's timezone will be used. |

BIN
source/images/integrations/datetime/state_datetime.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 22 KiB