This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
trigger:Cron [2017/10/10 00:09] peternlewis |
trigger:Cron [2021/11/24 01:45] peternlewis |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | The *Cron trigger* (v8+) lets you execute a macro periodically while you are logged in. | + | ====== Cron Trigger ====== |
+ | |||
+ | The *Cron* trigger (v8+) lets you execute a macro periodically while you are logged in. | ||
The Cron format lets you specify when a trigger will fire based on the time of day and and day of month and week. | The Cron format lets you specify when a trigger will fire based on the time of day and and day of month and week. | ||
Line 32: | Line 34: | ||
The [[token:TriggerValue|%TriggerValue%]] token will hold the current time and date (`yyyy-mm-dd hh:mm`). | The [[token:TriggerValue|%TriggerValue%]] token will hold the current time and date (`yyyy-mm-dd hh:mm`). | ||
+ | |||
+ | Remember that your Mac **must** be awake for any trigger to run, and that if the screen is sleeping, locked, or screen saving, then UI actions generally will not work. | ||
===== Examples ===== | ===== Examples ===== | ||
- | * `1 0 * * *` — triggers at one minute past midnight each day. | + | ^ Cron Setting ^ When Macro Triggers ^ |
- | * `45 23 * * 6` — triggers at 23:45 (15 minutes before midnight) near the end of each Saturday. | + | | `1 0 * * *` | AT one minute past midnight each day | |
- | * `0 12 * * Mon` — triggers at noon each Monday. | + | | `45 23 * * 6` | AT 23:45 (15 minutes before midnight) near the end of each Saturday | |
- | * `0 18 * * Fri` — triggers at 6pm each Friday. | + | | `0 12 * * Mon` | AT noon each Monday | |
- | * `0 9,12,18 * * *` — triggers at 9am, 12am and 3pm each day. | + | | `0 18 * * Fri` | AT 6pm each Friday | |
- | * `* * * * 1-5` — triggers at every minute on workdays. | + | | `0 9,12,18 * * *` | AT 9am, 12am and 3pm each day | |
- | * `*/15 * * * *` — triggers at every quarter hour. | + | | `* * * * 1-5` | AT EVERY minute on workdays | |
- | * `0 18-23,0-8 * * *` — triggers at every hour outside office hours. | + | | `*/15 * * * *` | AT EVERY quarter hour | |
- | * `0 12 1 Apr *` — triggers at noon on April 1st. | + | | `0 18-23,0-8 * * *` | AT EVERY hour outside office hours | |
- | * `0 12 15 * *` — triggers at noon the 15th of each month. | + | | `0 12 1 Apr *` | AT noon on April 1st | |
- | * `0 12 15 * Mon` — triggers at noon each Monday and the 15th of each month. | + | | `30 8 17 Apr * 2019` | AT 8:30am on 17 April, 2019 | |
- | * `0 12 15 * +Mon` — triggers at noon each 15th of each month if it is a Monday. | + | | `0 12 15 * *` | AT noon the 15th of each month | |
- | * `0-59/5 * * * *` — triggers every five minutes (at :00, :05, :10, etc). | + | | `0 12 15 * Mon` | AT noon each Monday and the 15th of each month | |
- | * `3-59/5 * * * *` — triggers every five minutes (at :03, :08, :13, etc). | + | | `0 12 15 * +Mon` | AT noon each 15th of each month if it is a Monday | |
+ | | `0-59/5 * * * *` | EVERY five minutes (AT :00, :05, :10, etc) | | ||
+ | | `3-59/5 * * * *` | EVERY five minutes (AT :03, :08, :13, etc) | | ||
+ | | `30 8 1-7 * +Sat` | AT 8:30 am on the first Saturday of each of month | | ||
===== See Also ===== | ===== See Also ===== | ||
- | * [[https://en.wikipedia.org/wiki/Cron|Cron]] format. None of the Non-standard characters are supported except the slash (/). | + | === Actions === |
- | * [[https://healthchecks.io/docs/cron/|HealthChecks.io examples]]. | + | |
+ | * [[:Actions|See all Actions]] | ||
+ | |||
+ | === Tokens === | ||
+ | |||
+ | * [[token:Trigger|%Trigger%]] | ||
+ | * [[token:TriggerBase|%TriggerBase%]] | ||
+ | * [[token:TriggerValue|%TriggerValue%]] | ||
+ | * [[:Tokens|See all Tokens]] | ||
=== Triggers === | === Triggers === | ||
Line 61: | Line 76: | ||
* [[Idle]] trigger | * [[Idle]] trigger | ||
* [[/Triggers|All Triggers]] | * [[/Triggers|All Triggers]] | ||
+ | |||
+ | ===== Forum ===== | ||
+ | |||
+ | * [[https://en.wikipedia.org/wiki/Cron|Cron]] format. None of the Non-standard characters are supported except the slash (/). | ||
+ | * [[https://healthchecks.io/docs/cron/|HealthChecks.io examples]]. | ||
+ |