From 9b6863f18279a9e2169e56dd7808f6d19eca30a1 Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Mon, 22 Apr 2024 23:12:22 +1200
Subject: [PATCH] ESPHome: Add datetime entities (#115942)

---
 homeassistant/components/esphome/datetime.py  | 48 +++++++++++
 .../components/esphome/entry_data.py          |  2 +
 tests/components/esphome/test_datetime.py     | 79 +++++++++++++++++++
 3 files changed, 129 insertions(+)
 create mode 100644 homeassistant/components/esphome/datetime.py
 create mode 100644 tests/components/esphome/test_datetime.py

diff --git a/homeassistant/components/esphome/datetime.py b/homeassistant/components/esphome/datetime.py
new file mode 100644
index 00000000000..15509a46158
--- /dev/null
+++ b/homeassistant/components/esphome/datetime.py
@@ -0,0 +1,48 @@
+"""Support for esphome datetimes."""
+
+from __future__ import annotations
+
+from datetime import datetime
+
+from aioesphomeapi import DateTimeInfo, DateTimeState
+
+from homeassistant.components.datetime import DateTimeEntity
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.core import HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback
+import homeassistant.util.dt as dt_util
+
+from .entity import EsphomeEntity, esphome_state_property, platform_async_setup_entry
+
+
+async def async_setup_entry(
+    hass: HomeAssistant,
+    entry: ConfigEntry,
+    async_add_entities: AddEntitiesCallback,
+) -> None:
+    """Set up esphome datetimes based on a config entry."""
+    await platform_async_setup_entry(
+        hass,
+        entry,
+        async_add_entities,
+        info_type=DateTimeInfo,
+        entity_type=EsphomeDateTime,
+        state_type=DateTimeState,
+    )
+
+
+class EsphomeDateTime(EsphomeEntity[DateTimeInfo, DateTimeState], DateTimeEntity):
+    """A datetime implementation for esphome."""
+
+    @property
+    @esphome_state_property
+    def native_value(self) -> datetime | None:
+        """Return the state of the entity."""
+        state = self._state
+        if state.missing_state:
+            return None
+        return dt_util.utc_from_timestamp(state.epoch_seconds)
+
+    async def async_set_value(self, value: datetime) -> None:
+        """Update the current datetime."""
+        self._client.datetime_command(self._key, int(value.timestamp()))
diff --git a/homeassistant/components/esphome/entry_data.py b/homeassistant/components/esphome/entry_data.py
index 52dc1f17ad6..a840fc3a17e 100644
--- a/homeassistant/components/esphome/entry_data.py
+++ b/homeassistant/components/esphome/entry_data.py
@@ -20,6 +20,7 @@ from aioesphomeapi import (
     ClimateInfo,
     CoverInfo,
     DateInfo,
+    DateTimeInfo,
     DeviceInfo,
     EntityInfo,
     EntityState,
@@ -68,6 +69,7 @@ INFO_TYPE_TO_PLATFORM: dict[type[EntityInfo], Platform] = {
     ClimateInfo: Platform.CLIMATE,
     CoverInfo: Platform.COVER,
     DateInfo: Platform.DATE,
+    DateTimeInfo: Platform.DATETIME,
     FanInfo: Platform.FAN,
     LightInfo: Platform.LIGHT,
     LockInfo: Platform.LOCK,
diff --git a/tests/components/esphome/test_datetime.py b/tests/components/esphome/test_datetime.py
new file mode 100644
index 00000000000..3bdc196de95
--- /dev/null
+++ b/tests/components/esphome/test_datetime.py
@@ -0,0 +1,79 @@
+"""Test ESPHome datetimes."""
+
+from unittest.mock import call
+
+from aioesphomeapi import APIClient, DateTimeInfo, DateTimeState
+
+from homeassistant.components.datetime import (
+    ATTR_DATETIME,
+    DOMAIN as DATETIME_DOMAIN,
+    SERVICE_SET_VALUE,
+)
+from homeassistant.const import ATTR_ENTITY_ID, STATE_UNKNOWN
+from homeassistant.core import HomeAssistant
+
+
+async def test_generic_datetime_entity(
+    hass: HomeAssistant,
+    mock_client: APIClient,
+    mock_generic_device_entry,
+) -> None:
+    """Test a generic datetime entity."""
+    entity_info = [
+        DateTimeInfo(
+            object_id="mydatetime",
+            key=1,
+            name="my datetime",
+            unique_id="my_datetime",
+        )
+    ]
+    states = [DateTimeState(key=1, epoch_seconds=1713270896)]
+    user_service = []
+    await mock_generic_device_entry(
+        mock_client=mock_client,
+        entity_info=entity_info,
+        user_service=user_service,
+        states=states,
+    )
+    state = hass.states.get("datetime.test_mydatetime")
+    assert state is not None
+    assert state.state == "2024-04-16T12:34:56+00:00"
+
+    await hass.services.async_call(
+        DATETIME_DOMAIN,
+        SERVICE_SET_VALUE,
+        {
+            ATTR_ENTITY_ID: "datetime.test_mydatetime",
+            ATTR_DATETIME: "2000-01-01T01:23:45+00:00",
+        },
+        blocking=True,
+    )
+    mock_client.datetime_command.assert_has_calls([call(1, 946689825)])
+    mock_client.datetime_command.reset_mock()
+
+
+async def test_generic_datetime_missing_state(
+    hass: HomeAssistant,
+    mock_client: APIClient,
+    mock_generic_device_entry,
+) -> None:
+    """Test a generic datetime entity with missing state."""
+    entity_info = [
+        DateTimeInfo(
+            object_id="mydatetime",
+            key=1,
+            name="my datetime",
+            unique_id="my_datetime",
+        )
+    ]
+    states = [DateTimeState(key=1, missing_state=True)]
+    user_service = []
+    await mock_generic_device_entry(
+        mock_client=mock_client,
+        entity_info=entity_info,
+        user_service=user_service,
+        states=states,
+    )
+    state = hass.states.get("datetime.test_mydatetime")
+    assert state is not None
+    assert state.state == STATE_UNKNOWN