From 24e54ac21a3856c30ced1302bbe8127583020ee1 Mon Sep 17 00:00:00 2001 From: cbhiii <10853381+cbhiii@users.noreply.github.com> Date: Mon, 30 Jan 2023 05:14:12 -0500 Subject: [PATCH] Update timer.markdown (#25993) --- source/_integrations/timer.markdown | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/source/_integrations/timer.markdown b/source/_integrations/timer.markdown index 4f542fe0661..df3c82b1c60 100644 --- a/source/_integrations/timer.markdown +++ b/source/_integrations/timer.markdown @@ -14,6 +14,11 @@ The `timer` integration aims to simplify automations based on (dynamic) duration When a timer finishes or gets canceled the corresponding events are fired. This allows you to differentiate if a timer has switched from `active` to `idle` because the given duration has elapsed or it has been canceled. To control timers in your automations you can use the services mentioned below. When calling the `start` service on a timer that is already running, it resets the duration it will need to finish and restarts the timer without triggering a canceled or finished event. This, for example, makes it easy to create timed lights that get triggered by motion. Starting a timer triggers a started event unless the timer is paused, in that case, it triggers a restarted event. +
+ +Timers will be restored to their correct state and time on Home Assistant startup and restarts when configured with the `restore` option. + +
## Configuration The preferred way to configure timer helpers is via the user interface at **Settings** -> **Devices & Services** -> **Helpers** and click the add button; next choose the **Timer** option. @@ -54,7 +59,7 @@ timer: required: false type: icon restore: - description: When true, active and paused timers will be restored to the right state on startup. If an active timer was supposed to end while Home Assistant is stopped, the `timer.finished` event will fire on startup for that timer. The `finished_at` property in the event data will provide you with the time that the timer was actually supposed to fire which you can use in automation conditions to decide whether or not to act on it. + description: When true, active and paused timers will be restored to the correct state and time on Home Assistant startup and restarts. If an active timer was supposed to end while Home Assistant is stopped, the `timer.finished` event will fire on startup for that timer. The `finished_at` property in the event data will provide you with the time that the timer was actually supposed to fire which you can use in automation conditions to decide whether or not to act on it. required: false type: boolean default: false