mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-04-25 13:57:37 +00:00
89b5af33bd
* States: add unavailable and unknown * rephrase intro * Make states lowercase * Update source/_integrations/humidifier.markdown Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com> * Revert "Make states lowercase" This reverts commit daf7f06630c4a2cc1f7e7fe5d043d9754a79cd1d. * Apply bold to the UI string of state names * Climate: fix grammar --------- Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com>
1.9 KiB
1.9 KiB
| title | description | ha_category | ha_release | ha_domain | ha_quality_scale | ha_codeowners | ha_integration_type | ||
|---|---|---|---|---|---|---|---|---|---|
| Date/Time | Instructions on how to set up date/time entities within Home Assistant. |
|
2023.6 | datetime | internal |
|
entity |
The Date/Time {% term integration %} is built for the controlling and monitoring of timestamps on devices.
{% include integrations/building_block_integration.md %}
If you are looking for a way to create a Date/Time entity, please take a look at the Date/Time helper.
The state of a date/time entity
The state of a date/time entity is the actual date and time value.
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.
In addition, the entity can have the following states:
- Unavailable: The entity is currently unavailable.
- Unknown: The state is not yet known.
Actions
datetime actions
Available {% term actions %}: datetime.set_value
Action datetime.set_value
Set a new value for the datetime {% term entity %}.
| Data attribute | Optional | Description |
|---|---|---|
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. |