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

 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<pre class="header-style">
 
<pre class="header-style">
This trigger will be fire on selected days 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 '''
  
When the battery level makes any change, this means that it will be activated at every battery change.
+
* '''Use Alarm Clock''' - When enabled, the system treats this as an alarm clock event, which may provide more reliable timing on some devices.
  
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:
 +
** 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)
  
'''Example Usage'''<br/>
+
''' Examples '''
Every 1st day of the month you will be reminded to have your vehicle serviced.
 
<pre class="trigger-style">
 
Triggers
 
  
Day of the month
+
Example 1: Weekly reminder on Mondays
1 every month (10:00)
+
 
</pre>
+
  <pre class="trigger-style">Triggers
<pre class="action-style">
+
 
Actions
+
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: Service reminder
+
* [[Trigger:_Regular_Interval|Regular Interval Trigger]]
Text: Today you must take the car to the maintenance service
+
* [[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