mirror of
https://github.com/home-assistant/developers.home-assistant.git
synced 2025-07-24 01:36:32 +00:00
Add time
entity developer docs (#1534)
Co-authored-by: Teemu R. <tpr@iki.fi>
This commit is contained in:
parent
14d0001d32
commit
eac4921e3f
36
docs/core/entity/time.md
Normal file
36
docs/core/entity/time.md
Normal file
@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Time Entity
|
||||
sidebar_label: Time
|
||||
---
|
||||
|
||||
A `time` is an entity that allows the user to input a time to an integration. Derive entity platforms from [`homeassistant.components.time.TimeEntity`](https://github.com/home-assistant/core/blob/dev/homeassistant/components/time/__init__.py)
|
||||
|
||||
## Properties
|
||||
|
||||
:::tip
|
||||
Properties should always only return information from memory and not do I/O (like network requests). Implement `update()` or `async_update()` to fetch data.
|
||||
:::
|
||||
|
||||
| Name | Type | Default | Description
|
||||
| ---- | ---- | ------- | -----------
|
||||
| native_value | time | **Required** | The value of the time.
|
||||
|
||||
Other properties that are common to all entities such as `icon`, `name` etc. are also applicable.
|
||||
|
||||
## Methods
|
||||
|
||||
### Set value
|
||||
|
||||
Called when the user or an automation wants to update the value.
|
||||
|
||||
```python
|
||||
class MyTime(TimeEntity):
|
||||
# Implement one of these methods.
|
||||
|
||||
def set_value(self, value: time) -> None:
|
||||
"""Update the current value."""
|
||||
|
||||
async def async_set_value(self, value: time) -> None:
|
||||
"""Update the current value."""
|
||||
|
||||
```
|
Loading…
x
Reference in New Issue
Block a user