Difference between revisions of "Trigger: Day/Time Trigger"

 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
<span style="color: #B22A2A; font-size: 24px; display: inline-block; margin-top: 15px; margin-bottom: 0px;"><strong>About this trigger</strong></span>
+
<pre class="header-style">
 +
This trigger can be configured to fire at a certain time of day on selected days of the week.
 +
</pre>
  
This trigger will be activated on a certain day of the week or day of the month.
+
''' Options '''
  
<span style="color: #B22A2A; font-size: 24px; display: inline-block; margin-top: 15px; margin-bottom: 0px;"><strong>Supported configurations</strong></span>
+
* '''Time''' - Set the hour, minute, and optionally seconds for when the trigger should fire.
  
=== Day/Time ===
+
* '''Days of Week''' - Select one or more days of the week when the trigger should be active. You can select any combination of Monday through Sunday.
  
You can choose a specific day of the week and time, for example, every Monday at 8 am.
+
* '''Use Alarm Clock''' - When enabled, the system treats this as an alarm clock event, which may provide more reliable timing on some devices that aggressively manage background processes.
  
Use this option if the trigger time is not accurate (and you need it), e.g., for high importance events, it is recommended to use an alarm.
+
* '''Use Variable''' - Instead of fixed values, you can use a dictionary variable to dynamically control the trigger timing. The variable should contain:
 +
** hour (integer 0-23)
 +
** minute (integer 0-59)
 +
** second (integer 0-59, optional)
 +
** days (array of 7 booleans for Mon, Tue, Wed, Thu, Fri, Sat, Sun)
 +
 
 +
''' Examples '''
 +
 
 +
Example 1: Morning alarm on weekdays
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Day/Time [07:00 Mon, Tue, Wed, Thu, Fri]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Play Sound: Alarm tone
 +
Set Volume: Media 70%</pre>
 +
 
 +
Example 2: Weekend notification
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Day/Time [10:00 Sat, Sun]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Notification: Good morning! Enjoy your weekend!</pre>
 +
 
 +
Example 3: Daily backup at midnight
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Day/Time [00:00 Mon - Sun]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Export Macros</pre>
 +
  <pre class="constraint-style">Constraints
 +
 
 +
WiFi Connected</pre>
 +
 
 +
''' Notes '''
 +
 
 +
* The trigger automatically adjusts for timezone changes, rescheduling when the timezone is modified.
 +
* When using variable mode, the trigger will automatically reschedule when the variable value changes.
 +
* The trigger schedules only the next upcoming alarm time, not all instances, for efficiency.
 +
* Requires the SCHEDULE_EXACT_ALARM permission on Android 12+ for reliable timing.
 +
* If you need a trigger for a specific day of the month rather than day of the week, use the Day of Week/Month trigger instead.
 +
 
 +
''' Permissions Required '''
 +
 
 +
* SCHEDULE_EXACT_ALARM (Android 12+)
 +
 
 +
''' See Also '''
 +
 
 +
* [[Trigger:_Day_of_Week/Month|Day of Week/Month Trigger]]
 +
* [[Trigger:_Regular_Interval|Regular Interval Trigger]]
 +
* [[Trigger:_Stopwatch|Stopwatch Trigger]]

Latest revision as of 22:40, 5 January 2026

This trigger can be configured to fire at a certain time of day on selected days of the week.

Options

  • Time - Set the hour, minute, and optionally seconds for when the trigger should fire.
  • Days of Week - Select one or more days of the week when the trigger should be active. You can select any combination of Monday through Sunday.
  • Use Alarm Clock - When enabled, the system treats this as an alarm clock event, which may provide more reliable timing on some devices that aggressively manage background processes.
  • Use Variable - Instead of fixed values, you can use a dictionary variable to dynamically control the trigger timing. The variable should contain:
    • hour (integer 0-23)
    • minute (integer 0-59)
    • second (integer 0-59, optional)
    • days (array of 7 booleans for Mon, Tue, Wed, Thu, Fri, Sat, Sun)

Examples

Example 1: Morning alarm on weekdays

Triggers

Day/Time [07:00 Mon, Tue, Wed, Thu, Fri]
Actions

Play Sound: Alarm tone
Set Volume: Media 70%

Example 2: Weekend notification

Triggers

Day/Time [10:00 Sat, Sun]
Actions

Notification: Good morning! Enjoy your weekend!

Example 3: Daily backup at midnight

Triggers

Day/Time [00:00 Mon - Sun]
Actions

Export Macros
Constraints

WiFi Connected

Notes

  • The trigger automatically adjusts for timezone changes, rescheduling when the timezone is modified.
  • When using variable mode, the trigger will automatically reschedule when the variable value changes.
  • The trigger schedules only the next upcoming alarm time, not all instances, for efficiency.
  • Requires the SCHEDULE_EXACT_ALARM permission on Android 12+ for reliable timing.
  • If you need a trigger for a specific day of the month rather than day of the week, use the Day of Week/Month trigger instead.

Permissions Required

  • SCHEDULE_EXACT_ALARM (Android 12+)

See Also