<info> <name>Drissi Mohieddine</name> m.drissi@protonmail.com <years>2020</years> <name>Danielle Vansia</name> daniellevansia@gmail.com <years>2020</years> </info>

Repeating tasks are the tasks that must be done many times, in a fixed period (day, week, month, year). By making a task repeat, the due date will hold the date by which the task must be completed. If a start date is set, the first occurrence of that task will begin from that start date.

Setting a Task to Repeat

You can set a task to repeat using one of the following methods:

<list> <item>

The <gui>Quick Add Entry</gui> is the fastest way. Use the keyword every when creating the task. See the Valid Recurring Terms section below for the valid syntax.

</item> <item>

From the <gui>Task Editor</gui>, click the circular arrow button to open the Recurring Task menu.

</item> <item>

From the <gui>Task Browser</gui>, right-click a task. Select Set Recurring to open the Recurring Task context menu.

</item> </list>

In the <gui>Task Editor</gui>, the circular arrow button is displayed as light blue to notify you when the task is set to recurring. The circular arrow icon is also displayed next to a task in the <gui>Task Browser</gui>.

If you set a parent task to repeat, the associated subtasks will also be set to repeat.

Valid Recurring Terms

The valid terms are very similar to the Keyword Parsing Syntax for start and due dates with the exception of a few keywords.

Recurring Term Syntax
Syntax | Example
`yyyy-mm-dd` or `yyyy/mm/dd` | 2020-04-01 or 2020/04/01. This will repeat every year on 04/01.
`yyyymmdd` | 20200401 This will repeat every year on 04/01.
`mmdd` | 0401 (with the year being assumed as the current one). This will repeat every year on 04/01.
`day` | With this syntax, the task repeats daily.
`other-day` | With this syntax, the task repeats every other day.
`week` | Will repeat every week on the same day that the task was set.
`month` | Will repeat monthly.
`year` | Will repeat yearly.
`Monday` (or any day of the week) | Will repeat on that day of the week
`27` (or any day's number) | In this example, the task will recur on every 27 of the month.

Recurring Examples

Below are some examples of how recurring terms work. These examples are made using the <gui>Quick Add Entry</gui> but do not differ in result from the <gui>Task Editor</gui>.

<terms> <item> <em style="strong"><code>pay my taxes every:year</code></em>

This task will repeat every year on the date that the task was created.

</item> <item> <em style="strong"><code>Go out with my dog every:day start:tomorrow</code></em>

By setting a start date, this task will not recur every date from today's date but from the start date.

</item> </terms>