Difference between revisions of "Trigger: Day of Week/Month"
(→About) |
|||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | < | + | <pre class="header-style"> |
| + | This trigger will fire at a fixed time on the selected day of the week or day of the month. | ||
| + | </pre> | ||
| + | |||
| + | ''' 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 | ||
| + | |||
| + | <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 | + | <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 ''' | |
| − | |||
| − | + | * [[Trigger:_Day/Time_Trigger|Day/Time Trigger]] | |
| − | + | * [[Trigger:_Regular_Interval|Regular Interval Trigger]] | |
| + | * [[Trigger:_Calendar_Event|Calendar Event Trigger]] | ||
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