For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /developers/core/entity/datetime.md.

Date/Time 实体

datetime 是一种允许用户向集成输入时间戳的实体。从 homeassistant.components.datetime.DateTimeEntity 派生实体平台。

属性

Tip

属性应始终仅返回内存中的信息，而不是执行 I/O（如网络请求）。实现 update() 或 async_update() 来获取数据。

名称	类型	默认值	描述
native_value	`datetime.datetime \| None`	必填	datetime 的值。必须包含时区信息。

所有实体共有的其他属性（如 icon、name 等）也适用。

方法

设置值

当用户或自动化想要更新值时调用。提供的 datetime 始终包含时区信息；无时区的 datetime 将被视为处于 Home Assistant 配置的时区。

class MyDateTime(DateTimeEntity):
    # 实现以下方法之一。

    def set_value(self, value: datetime) -> None:
        """Update the current value."""

    async def async_set_value(self, value: datetime) -> None:
        """Update the current value."""