Timer

The timer starts counting up from zero seconds once started and continues until manually stopped. Moreover, it's capable of exceeding its initial set duration, which allows it to show progress beyond 100% or display negative seconds left. This functions is useful for tracking tasks that may exceed their expected time frames, offering flexibility in monitoring extended workflows.

To quickly start with timers:

1. Find the Functions panel on the left-hand side of the screen.

2. Expand Utilities and then Timer.

3. Create a timer instance with the create function.

4. Expand the instance that appeared in the panel and get started with using the timer.

Use the create and delete functions to manage the existing timers. Existing timers can be seen in the functions panel on the left under Timer. Yellow ones are uninstantiated and green ones are ready for use.

Creating a timer

To create a timer:

1. Insert a timer name in the yellow field.

2. Click the trigger field to create an instance of the timer. You should see the timer in the functions panel go from yellow to green.

Deleting a timer

To delete a timer:

1. Insert the name of an existing timer in the yellow field

2. Click the trigger field.

Timer functions

To utilize timers, you can find functions tied to each instance when you expand the instance with a click on the arrow in front of it.

Setting timer

The setTotalSeconds function sets the timer's total duration in seconds. Enter the duration in the input field as an integer. The countdown starts when the start function is activated.

Getting timer duration

The getTotalSeconds function returns the number of seconds of the total timer duration.

Getting seconds left

The getSecondsLeft function returns the number of seconds left for the timer to run.

Getting timer progress

The getProgress function returns the progress of the timer in percent.

Getting timer state

The getState function returns whether the timer is stopped or started as a string.

Starting timer

After triggering the start function, the timer counts up and the state gets set to started. It will not stop until the stop function is triggered.

Stopping timer

After triggering the stop function, the timer stops counting, the state gets reset to stopped and the progress to 0.

Listening to timer ticks

The onTick function is triggered every time the timer updates. It shows the seconds left in the first field immediately after the timer changes. The function needs to be started once by being triggered to begin listening to the timer once the app is running. The resetting of the timer when it reaches 0 and a stopped timer will not register as a tick. You can use the first field just like any output field.

Listening for when the timer reaches zero

To listen for when the timer has reached its end, you can use onTimeup. On time up, this function fills its first field with an event that can be used as an input to other functions. Just like onTick, this function needs to be started by being triggered once the app is running.