Difference between revisions of "Trigger: Day of Week/Month"

 
Line 1: Line 1:
 
<pre class="header-style">
 
<pre class="header-style">
This trigger will fire at a fixed time on the selected day of the week or month.
+
This trigger will fire at a fixed time on the selected day of the week or day of the month.
 
</pre>
 
</pre>
  
'''Configuration Options'''
+
''' Options '''
  
* Day of the week
+
* '''Day of the Week''' - Select a specific day of the week (Monday through Sunday) and a time for the trigger to fire. The trigger will fire every week on that day at the specified time.
  
Choose a day of the week (Monday to Sunday) and then a time of activation.
+
* '''Day of the Month''' - Select a specific day of the month (1-31) and optionally a specific month. The trigger will fire on that date at the specified time.
 +
** If "Every month" is selected, the trigger fires on that day every month
 +
** If a specific month is selected, the trigger fires only once per year on that date
 +
** If the selected day doesn't exist in a month (e.g., 31st in February), the trigger will skip that month
  
* Day of the month
+
''' Advanced Options '''
  
Choose a day of the month (1-31) and then a time of activation.
+
* '''Use Alarm Clock''' - When enabled, the system treats this as an alarm clock event, which may provide more reliable timing on some devices.
  
'''Example Usage'''<br/>
+
* '''Use Variable''' - Instead of fixed values, you can use a dictionary variable to dynamically control the trigger timing. The variable should contain:
On the 1st day of each month you will be reminded to check your vehicle's oil, water and tyres.
+
** For Day of Week: hour, minute, and days (array of 7 booleans for Mon-Sun)
<pre class="trigger-style">
+
** For Day of Month: hour, minute, dayOfMonth, and months (array of 12 booleans for Jan-Dec)
Triggers
 
  
Day of the month - 1st every month (10:00)
+
''' Examples '''
</pre>
+
 
<pre class="action-style">
+
Example 1: Weekly reminder on Mondays
Actions
+
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Day of Week [Monday 09:00]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Notification: Start of the work week!</pre>
 +
 
 +
Example 2: Monthly car maintenance reminder
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Day of Month [1st Every month 10:00]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Notification: Car check reminder
 +
Message: Please remember to check the car oil, water and tyres.</pre>
 +
 
 +
 
 +
''' Notes '''
 +
 
 +
* The trigger automatically adjusts for timezone changes, rescheduling the alarm when the timezone is modified.
 +
* When using variable mode, the trigger will automatically reschedule when the variable value changes.
 +
* For months that don't have the specified day (e.g., February 30th), the trigger automatically finds the next valid month.
 +
* Requires the SCHEDULE_EXACT_ALARM permission on Android 12+ for reliable timing.
 +
* For weekly recurring triggers on multiple days, consider using the Day/Time trigger instead.
 +
 
 +
''' Permissions Required '''
 +
 
 +
* SCHEDULE_EXACT_ALARM (Android 12+)
 +
 
 +
''' See Also '''
  
Display notification
+
* [[Trigger:_Day/Time_Trigger|Day/Time Trigger]]
TItle: Car check reminder
+
* [[Trigger:_Regular_Interval|Regular Interval Trigger]]
Text: Please remember to check the car oil, water and tyres.
+
* [[Trigger:_Calendar_Event|Calendar Event Trigger]]
</pre>
 

Latest revision as of 22:37, 5 January 2026

This trigger will fire at a fixed time on the selected day of the week or day of the month.

Options

  • Day of the Week - Select a specific day of the week (Monday through Sunday) and a time for the trigger to fire. The trigger will fire every week on that day at the specified time.
  • Day of the Month - Select a specific day of the month (1-31) and optionally a specific month. The trigger will fire on that date at the specified time.
    • If "Every month" is selected, the trigger fires on that day every month
    • If a specific month is selected, the trigger fires only once per year on that date
    • If the selected day doesn't exist in a month (e.g., 31st in February), the trigger will skip that month

Advanced Options

  • Use Alarm Clock - When enabled, the system treats this as an alarm clock event, which may provide more reliable timing on some devices.
  • Use Variable - Instead of fixed values, you can use a dictionary variable to dynamically control the trigger timing. The variable should contain:
    • For Day of Week: hour, minute, and days (array of 7 booleans for Mon-Sun)
    • For Day of Month: hour, minute, dayOfMonth, and months (array of 12 booleans for Jan-Dec)

Examples

Example 1: Weekly reminder on Mondays

Triggers

Day of Week [Monday 09:00]
Actions

Notification: Start of the work week!

Example 2: Monthly car maintenance reminder

Triggers

Day of Month [1st Every month 10:00]
Actions

Notification: Car check reminder
Message: Please remember to check the car oil, water and tyres.


Notes

  • The trigger automatically adjusts for timezone changes, rescheduling the alarm when the timezone is modified.
  • When using variable mode, the trigger will automatically reschedule when the variable value changes.
  • For months that don't have the specified day (e.g., February 30th), the trigger automatically finds the next valid month.
  • Requires the SCHEDULE_EXACT_ALARM permission on Android 12+ for reliable timing.
  • For weekly recurring triggers on multiple days, consider using the Day/Time trigger instead.

Permissions Required

  • SCHEDULE_EXACT_ALARM (Android 12+)

See Also