Skip to content

Flows Actions timer_get_duration

Arie J. Godschalk edited this page Nov 15, 2026 · 1 revision

Home · Flows · Actions

Get the duration of a timer

What it does

Returns elapsed and remaining time in numeric and formatted Flow tokens.

Before you start

  • Use the exact type and name you want to target. A timer and another chronograph type with the same name are separate.
  • Make sure the named chronograph exists before using this action; resume-existing, pause, adjust, stop and duration actions need an active or paused instance.

Arguments

Field Type How to use it
Pick autocomplete Choose or type a configured name.
Name (* BLL supported) text Used if Pick is empty; Pick wins if both are set. Accepts BLL code when Better Logic Library is installed.

Enter a name in Name or choose one in Pick. The picker takes precedence if both are set. Names appear in suggestions after a relevant enabled Flow has been saved. * matching is supported only where noted below; it cannot be used to create a chronograph.

Output tokens

Token (key) Type Meaning
Name (name) string The exact configured chronograph name.
Duration in Milliseconds (duration) number Remaining time in milliseconds.
Duration in Seconds (durationInSeconds) number Remaining time converted to this unit and rounded to the decimal-place setting on the General tab.
Duration in Minutes (durationInMinutes) number Remaining time converted to this unit and rounded to the decimal-place setting on the General tab.
Duration in Hours (durationInHours) number Remaining time converted to this unit and rounded to the decimal-place setting on the General tab.
Duration in Minutes (durationTimeInMinutes) string Remaining time formatted as minutes and seconds or hours and minutes/seconds.
Duration in Hours (durationTimeInHours) string Remaining time formatted as minutes and seconds or hours and minutes/seconds.
Duration in Hours (short) (durationTimeInHoursShort) string Remaining time formatted as minutes and seconds or hours and minutes/seconds.
Elapsed in Milliseconds (elapsed) number Elapsed time in milliseconds.
Elapsed in Seconds (elapsedInSeconds) number Elapsed time converted to this unit and rounded to the decimal-place setting on the General tab.
Elapsed in Minutes (elapsedInMinutes) number Elapsed time converted to this unit and rounded to the decimal-place setting on the General tab.
Elapsed in Hours (elapsedInHours) number Elapsed time converted to this unit and rounded to the decimal-place setting on the General tab.
Elapsed in Minutes (elapsedTimeInMinutes) string Elapsed time formatted as minutes and seconds or hours and minutes/seconds.
Elapsed in Hours (elapsedTimeInHours) string Elapsed time formatted as minutes and seconds or hours and minutes/seconds.
Elapsed in Hours (short) (elapsedTimeInHoursShort) string Elapsed time formatted as minutes and seconds or hours and minutes/seconds.

Behavior and limitations

  • Use one exact name. This card does not match wildcard names.

Example

Start Kitchen fan for 10 minutes, then add this action with Name Kitchen fan before a notification. Connect Duration in Minutes for remaining time, or Elapsed in Minutes for time passed. Expected result: the message uses that value; the action reports an error if absent.

Related pages

Full actions guide · All cards · Examples · Troubleshooting

Clone this wiki locally