From df58e99b302d6b00d39a8e37fcc7a390c0bd111c Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Thu, 15 Feb 2024 20:45:51 +0100
Subject: [PATCH] Event entity definition: rephrase (#31448)
---
source/_integrations/event.markdown | 9 ++++++---
.../integrations/event/event_timestamp.png | Bin 0 -> 33457 bytes
2 files changed, 6 insertions(+), 3 deletions(-)
create mode 100644 source/images/integrations/event/event_timestamp.png
diff --git a/source/_integrations/event.markdown b/source/_integrations/event.markdown
index ba6f28cc175..1053cda4ce3 100644
--- a/source/_integrations/event.markdown
+++ b/source/_integrations/event.markdown
@@ -13,7 +13,7 @@ ha_integration_type: entity
Events are signals that are emitted when something happens, for example, when a user presses a physical button like a doorbell or when a button on a remote control is pressed.
-These events are stateless. For example, a doorbell does not have a state like being "on" or "off" but instead is momentarily pressed. Some events can have variations in the type of event that is emitted. For example, maybe your remote control is capable of emitting a single press, a double press, or a long press.
+These events do not capture a state in the traditional sense. For example, a doorbell does not have a state such as "on" or "off" but instead is momentarily pressed. Some events can have variations in the type of event that is emitted. For example, maybe your remote control is capable of emitting a single press, a double press, or a long press.
The event entity can capture these events in the physical world and makes them available in Home Assistant as an entity.
@@ -21,9 +21,12 @@ The event entity can capture these events in the physical world and makes them a
## The state of an event entity
-The event entity is stateless, as in, it cannot have a state like the `on` or `off` state that, for example, a normal switch or light entity has.
+The event entity does not capture a state such as `on` or `off`. Instead, an event entity keeps track of the timestamp when the emitted event has last been detected.
-Therefore, every event entity keeps track of the timestamp when the emitted event has last been detected.
+
+
+ Event entity with a timestamp value in state and event type "pressed".
+
Because the state of an event entity in Home Assistant is a timestamp, it means we can use it in our automations. For example:
diff --git a/source/images/integrations/event/event_timestamp.png b/source/images/integrations/event/event_timestamp.png
new file mode 100644
index 0000000000000000000000000000000000000000..3c0a010d03bd280402e4874d0a3b5dba4f381779
GIT binary patch
literal 33457
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
literal 0
HcmV?d00001