From a15c605d1d8ad53bad4205201df480df1fa641b6 Mon Sep 17 00:00:00 2001 From: kloggy <38220016+kloggy@users.noreply.github.com> Date: Thu, 7 Apr 2022 12:06:46 +0100 Subject: [PATCH] Update timer.markdown (#22284) --- source/_integrations/timer.markdown | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/source/_integrations/timer.markdown b/source/_integrations/timer.markdown index 0649ca50fb7..b3c8f9b41b1 100644 --- a/source/_integrations/timer.markdown +++ b/source/_integrations/timer.markdown @@ -13,9 +13,6 @@ 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 restart 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. -
- With the current implementation timers don't persist over restarts. After a restart, they will be idle again, together with their initial configuration. -
## Configuration The preferred way to configure timer helpers is via the user interface. To add one, go to Configuration -> Automations & Scenes, select the "Helpers" tab and click the add button; next choose the “Timer” option. @@ -56,7 +53,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 `time.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 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. required: false type: boolean default: false