Dirks Logbuch

German text below. / Deutscher Text weiter unten.

The next part of my mini series about Taskwarrior is about dates, dateformat, due dates and wait dates.

Previous part

The standard date format is m/d/Y. That means the following:

m minimal-digit month, for example 1 or 12
d minimal-digit day, for example 1 or 30
y two-digit year, for example 09
D two-digit day, for example 01 or 30
M two-digit month, for example 01 or 12
Y four-digit year, for example 2009
a short name of weekday, for example Mon or Wed
A long name of weekday, for example Monday or Wednesday
b short name of month, for example Jan or Aug
B long name of month, for example January or August
V weeknumber, for example 03 or 37
H two-digit hour, for example 03 or 11
N two-digit minutes, for example 05 or 42
S two-digit seconds, for example 07 or 47

And, you guess it, it is configurable. Since I am not familiar with the American way of printing dates, I modified the dateformat for everything to YMD. This can be done in ~/.taskrc

$ grep ^dateformat ~/.taskrc
dateformat=YMD # Preferred input and display date format
dateformat.holiday=YMD # Preferred input date format for holidays
dateformat.report=YMD # Preferred display date format for reports
dateformat.annotation=YMD-HN # Preferred display date format for annotations

With this in mind, you can set dates to your tasks. "due" manages the due date of your task, "wait" edits a task to not show up in lists before that specific day.

task shell # makes it a lot easier since you do not need to type the word "task" before any command
task> add Pay rent
Created task 1
task> list

ID Project Pri Due Active Age Description
1 8 secs Pay rent

1 task
task> 1 due:20100731
Modified 1 task
task> list

ID Project Pri Due Active Age Description
1 20100731 1 min Pay rent

1 task
task> quit

Did you notice that the color changed?

I want to do that task tomorrow and I do not want to be bothered with seeing it before tomorrow.

task> 1 wait:20100729
Modified 1 task
task> list
No matches.

Apart from using abolut dates, you can use relative ones as well.

task ... due:today
task ... due:yesterday
task ... due:tomorrow
task ... due:23rd # next occuring 23rd
task ... due:eow # end of week
task ... due:eom # end of month
task ... due:eoy # end of year
task ... due:fri # next occuring Friday
task ... due:wed # next occuring Wednesday (not today!)

The next version of taskwarrior will have the "start of" commands as well.

With this very basic knowledge you can already do a lot of work, I will talk/write about recurring tasks later on.

task add due:20100731 wait:20100724 Pay rent
task add due:20100831 wait:20100824 Pay rent
task add due:20101225 wait:eom Buy christmas presents

To be continued ...

Deutscher Text. / German text.

In diesem zweiten Teil über Taskwarrior geht es um Daten (Termine), Datumsformate, Zieltermine und Wartetermin.

Letzte Episode

Das Standard-Datumsformat ist m/d/Y, was das folgende bedeutet:

m minimale Ziffern für den Monat, beispielsweise 1 oder 12
d minimale Ziffern für den Tag, beispielsweise 1 or 30
y zwei Ziffern für das Jahr, beispielsweise 09
D zwei Ziffern für den Tag, beispielsweise 01 oder 30
M zwei Ziffern für den Monat, beispielsweise 01 oder 12
Y four-digit year, beispielsweise 2009
a Kurzname des Wochentags in englischer Sprache, beispielsweise Mon oder Wed
A Langname des Wochentags in englischer Sprache, beispielsweise Monday oder Wednesday
b Kurzname des Monats (Englisch), beispielsweise Jan oder Aug
B Langname des Monats (Englisch), beispielsweise January oder August
V Wochennummer, beispielsweise 03 oder 37
H die Stunde mit zwei Ziffern, beispielsweise 03 oder 11
N die Minute mit zwei Ziffern, beispielsweise 05 oder 42
S die Sekunde mit zwei Ziffern, beispielsweise 07 oder 47

Und, wie Ihr wahrscheinlich vermutet, ist das konfigurierbar. Da ich mit dem amerikanischen Datumsformat nichts anfangen kann, habe ich es auf YMD gesetzt (D.M.Y) wäre auch möglich. Das kann in der Datei ~/.taskrc eingestellt werden.

$ grep ^dateformat ~/.taskrc
dateformat=YMD # präferiertes Ein- und Ausgabedatumsformat
dateformat.holiday=YMD # Bevorzugtes Eingabedatumsformat für Urlaub und Feiertage
dateformat.report=YMD # Bevorzugtes Ausgabedatumsformat für Reports
dateformat.annotation=YMD-HN # Bevorzugtes Ausgabedatumsformat für Anmerkungen

Mit dem im Hinterkopf könnt Ihr Daten an Eure Aufgaben hängen. "due" für Zieltermine, "wait" für Wartezeiten bis zu dem die Aufgabe in den Übersichten ausgeblendet wird.

task shell # das macht es ein bisschen einfacher, da braucht man nicht mehr "task" vor jedem Kommando zu tippen
task> add Miete zahlen
Created task 1
task> list

ID Project Pri Due Active Age Description
1 8 secs Miete zahlen

1 task
task> 1 due:20100731
Modified 1 task
task> list

ID Project Pri Due Active Age Description
1 20100731 1 min Miete zahlen

1 task
task> quit

Habt Ihr gesehen, dass sich die Farbe geändert hat?

Ich möchte die Aufgabe morgen erledigen und heute nicht mehr in meiner Liste haben.

task> 1 wait:20100729
Modified 1 task
task> list
No matches.

Losgelöst von absoluten Datumsangaben können auch relative verwendet werden (immer in englischer Sprache)

task ... due:today # Heute
task ... due:yesterday # Gestern
task ... due:tomorrow # Morgen
task ... due:23rd # der nächste 23te
task ... due:eow # Ende der Woche
task ... due:eom # Ende des Monats
task ... due:eoy # Ende des Jahres
task ... due:fri # der nächste Freitag
task ... due:wed # der nächste Mittwoch (nicht heute!)

In der nächsten Version von Taskwarrior wird es auch die "start of" Daten geben (sow, som, soy).

Mit dem bis jetzt erreichten Basiswissen, kann bereits eine grosse Menge an Arbeit erledigt werden. Über wiederkehrende Aufgaben schreibe ich später.

task add due:20100731 wait:20100724 Miete zahlen
task add due:20100831 wait:20100824 Miete zahlen
task add due:20101225 wait:eom Weihnachtsgeschenke kaufen

Fortsetzung folgt ...