55 lines
1.5 KiB
Markdown
55 lines
1.5 KiB
Markdown
# today
|
|
|
|
## `DATE` annotations
|
|
|
|
Most commands allow or require `DATE` annotations. They are roughly structured
|
|
like `DATE start [-- end]`. The `end` part can only contain time-related
|
|
information if the `start` specifies a time.
|
|
|
|
More specifically, there are three variants of the `DATE` annotation:
|
|
```
|
|
DATE date [delta] [time] [-- [date] [delta] [time]] [; delta]
|
|
DATE weekday [time] [-- [weekday] [delta] [time]]
|
|
DATE formula [delta] [time] [-- [delta] [time]]
|
|
```
|
|
|
|
In all three cases, the `end` must contain at least one of the optional elements
|
|
if it is present. Deltas in the `end` may represent fractional days (e. g.
|
|
`+3h`) as long as they are not immediately followed by a time and the `start`
|
|
includes a time. Other deltas may only represent whole-day intervals (they may
|
|
contain sub-day specifiers like `+24h` or `+25h-60m` as long as they sum to a
|
|
whole-day interval).
|
|
|
|
In the case of the `date` variant, a repetition delta can be specified following
|
|
a semicolon.
|
|
|
|
If multiple `DATE` annotations from a single command start on the same date, all
|
|
except the first are ignored.
|
|
|
|
## Examples
|
|
```
|
|
NOTE Spielerunde
|
|
DATE sun 22:00 -- 24:00
|
|
DATE sun 22:00 -- 00:00
|
|
DATE sun 22:00 -- +2h
|
|
DATE (wd = sun) 22:00 -- 24:00
|
|
DATE 2021-11-07 22:00 -- 24:00; +w
|
|
DATE 2021-11-07 22:00 -- +2h; +w
|
|
|
|
NOTE daily
|
|
DATE *
|
|
DATE (true)
|
|
DATE 2021-11-07; +d
|
|
|
|
NOTE on weekends
|
|
DATE (wd = sat | wd = sun)
|
|
|
|
NOTE weekends
|
|
DATE sat -- sun
|
|
DATE 2021-11-06 -- 2021-11-07; +w
|
|
DATE 2021-11-06 -- +d; +w
|
|
DATE (wd = sat) -- +d
|
|
|
|
NOTE last of each month
|
|
DATE (m = 1) -d
|
|
```
|