Skip to content

Commit d216a16

Browse files
committed
docs: Record limitations task date support, to aid user support
1 parent 75893b5 commit d216a16

File tree

2 files changed

+25
-0
lines changed

2 files changed

+25
-0
lines changed

docs/Getting Started/Dates.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -202,3 +202,24 @@ However, it is possible to search for any tasks with invalid dates in your vault
202202

203203
> [!warning]
204204
The date values on task lines must be calendar or absolute dates, referring to a specific year, month and day. Text such as `📅 today` is not understood by the Tasks plugin, and will not be found in searches.
205+
206+
## Limitations of task date support
207+
208+
### Date format is not configurable
209+
210+
- The date format on task lines is not yet configurable.
211+
- The only format recognised is `YYYY-MM-DD`, for example `2024-09-17`.
212+
- It is not possible to customise the format of date values on task lines.
213+
- It is also not possible to format dates as links, such as `[[2024-09-17]]`.
214+
- We are tracking this in [discussion #69](https://github.com/obsidian-tasks-group/obsidian-tasks/discussions/69).
215+
216+
### Dates cannot include times
217+
218+
- It is not yet possible to include times on task lines to indicate when they *should* be acted on.
219+
- Nor is it possible to record the time when tasks were created, completed or cancelled.
220+
- We are tracking this in discussions [#607](https://github.com/obsidian-tasks-group/obsidian-tasks/discussions/607) and [#668](https://github.com/obsidian-tasks-group/obsidian-tasks/discussions/668).
221+
222+
### Time-tracking, productivity tracking, pomodoros, notifications and similar out-of-scope
223+
224+
- The following are out-of-scope for the Tasks plugin: time-tracking, productivity tracking, pomodoros, notifications and similar.
225+
- We recorded this in [discussion #2721](https://github.com/obsidian-tasks-group/obsidian-tasks/discussions/2721).

docs/Support and Help/Known Limitations.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,10 @@ This page gathers together all the documentation on known limitations of the plu
3131

3232
![[Getting Started#Limitations and warnings]]
3333

34+
## Writing Tasks: Dates
35+
36+
![[Dates#Limitations of task date support]]
37+
3438
## Writing Tasks: Dependencies
3539

3640
![[Task Dependencies#Known Limitations]]

0 commit comments

Comments
 (0)