@@ -25,11 +25,13 @@ parent: Queries
25
25
` <date> ` filters can be given in natural language or in formal notation.
26
26
The following are some examples of valid ` <date> ` filters as inspiration:
27
27
28
- - ` 2021-05-05 `
28
+ - ` 2021-05-25 `
29
+ - ` yesterday `
29
30
- ` today `
30
31
- ` tomorrow `
31
32
- ` next monday `
32
33
- ` last friday `
34
+ - ` 14 days ago `
33
35
- ` in two weeks `
34
36
35
37
Note that if it is Wednesday and you write ` tuesday ` , Tasks assumes you mean "yesterday", as that is the closest Tuesday.
@@ -39,7 +41,7 @@ When the day changes, relative dates like `due today` are re-evaluated so that t
39
41
40
42
---
41
43
42
- ## Matching
44
+ ## Matching - Workaround for Boolean OR
43
45
44
46
All filters of a query have to match in order for a task to be listed.
45
47
This means you cannot show tasks that have "GitHub in the path and have no due date or are due after 2021-04-04".
@@ -61,7 +63,7 @@ Instead you would have two queries, one for each condition:
61
63
62
64
---
63
65
64
- ## List of Available Filters
66
+ ## Filters for Dates in Tasks
65
67
66
68
### Done Date
67
69
@@ -73,22 +75,21 @@ Instead you would have two queries, one for each condition:
73
75
74
76
> ` no done date ` and ` has done date ` were introduced in Tasks 1.7.0.
75
77
76
- ### Priority
78
+ ### Due Date
77
79
78
- - ` priority is (above|below)? (low|none|medium|high) `
80
+ - ` no due date `
81
+ - ` has due date `
82
+ - ` due (before|after|on) <date> `
79
83
80
- #### Examples
84
+ > ` has due date ` was introduced in Tasks 1.6.0.
81
85
82
- {: .no_toc }
86
+ ### Scheduled Date
83
87
84
- ```tasks
85
- not done
86
- priority is above none
87
- ```
88
+ - ` no scheduled date `
89
+ - ` has scheduled date `
90
+ - ` scheduled (before|after|on) <date> `
88
91
89
- ```tasks
90
- priority is high
91
- ```
92
+ > ` has scheduled date ` was introduced in Tasks 1.6.0.
92
93
93
94
### Start Date
94
95
@@ -108,22 +109,6 @@ Such filter could be:
108
109
starts before tomorrow
109
110
```
110
111
111
- ### Scheduled Date
112
-
113
- - ` no scheduled date `
114
- - ` has scheduled date `
115
- - ` scheduled (before|after|on) <date> `
116
-
117
- > ` has scheduled date ` was introduced in Tasks 1.6.0.
118
-
119
- ### Due Date
120
-
121
- - ` no due date `
122
- - ` has due date `
123
- - ` due (before|after|on) <date> `
124
-
125
- > ` has due date ` was introduced in Tasks 1.6.0.
126
-
127
112
### Happens
128
113
129
114
- ` happens (before|after|on) <date> `
@@ -140,29 +125,42 @@ because the tasks starts before tomorrow. Only one of the dates needs to match.
140
125
141
126
> ` no happens date ` and ` has happens date ` were introduced in Tasks 1.7.0.
142
127
143
- ### Recurrence
128
+ ## Filters for Other Task Properties
144
129
145
- - ` is recurring `
146
- - ` is not recurring `
147
-
148
- ### File Path
149
-
150
- - ` path (includes|does not include) <path> `
151
- - Matches case-insensitive (disregards capitalization).
130
+ As well as the date-related searches above, these filters search other properties in individual tasks.
152
131
153
132
### Description
154
133
155
134
- ` description (includes|does not include) <string> `
156
135
- Matches case-insensitive (disregards capitalization).
157
136
- Disregards the global filter when matching.
158
137
159
- ### Heading
138
+ ### Priority
160
139
161
- - ` heading (includes|does not include) <string> `
162
- - Whether or not the heading preceding the task includes the given string.
163
- - Always tries to match the closest heading above the task, regardless of heading level.
164
- - ` does not include ` will match a task that does not have a preceding heading in its file.
165
- - Matches case-insensitive (disregards capitalization).
140
+ - ` priority is (above|below)? (low|none|medium|high) `
141
+
142
+ #### Examples
143
+
144
+ {: .no_toc }
145
+
146
+ ```tasks
147
+ not done
148
+ priority is above none
149
+ ```
150
+
151
+ ```tasks
152
+ priority is high
153
+ ```
154
+
155
+ ### Recurrence
156
+
157
+ - ` is recurring `
158
+ - ` is not recurring `
159
+
160
+ ### Status
161
+
162
+ - ` done `
163
+ - ` not done `
166
164
167
165
### Sub-Items
168
166
@@ -183,3 +181,20 @@ because the tasks starts before tomorrow. Only one of the dates needs to match.
183
181
184
182
- ` tags include #todo `
185
183
- ` tags do not include #todo `
184
+
185
+ ## Filters for File Properties
186
+
187
+ These filters allow searching for tasks in particular files and sections of files.
188
+
189
+ ### File Path
190
+
191
+ - ` path (includes|does not include) <path> `
192
+ - Matches case-insensitive (disregards capitalization).
193
+
194
+ ### Heading
195
+
196
+ - ` heading (includes|does not include) <string> `
197
+ - Whether or not the heading preceding the task includes the given string.
198
+ - Always tries to match the closest heading above the task, regardless of heading level.
199
+ - ` does not include ` will match a task that does not have a preceding heading in its file.
200
+ - Matches case-insensitive (disregards capitalization).
0 commit comments