taskwarrior, one task at a time

computing
1

This note tracks challenges and solutions while using taskwarrior.

Continuation of Learning Taskwarrior, one dream at a time - Science and Technology - talkgroup.

2

Synonyms 2.4.0

In addition to formatted dates, you can use a date synonym instead:

$ task add Pay the rent due:eom

Here the synonym eom means ’end of the month’. Synonyms are a useful shortcut to entering lengthy dates. Here is the full set:

  • now - Current local date and time.
  • today - Current local date, with time 00:00:00.
  • sod - Current local date, with time 00:00:00. Same as today.
  • eod - Current local date, with time 23:59:59.
  • yesterday - Local date for yesterday, with time 00:00:00.
  • tomorrow - Local date for tomorrow, with time 00:00:00.
  • monday, tuesday, … - Local date for the specified day, after today, with time 00:00:00. Can be shortened, e.g. mon, tue 2.6.0 Can be capitalized, e.g. Monday, Tue
  • january, february, … - Local date for the specified month, 1st day, with time 00:00:00. Can be shortened, e.g. jan, feb. 2.6.0 Can be capitalized, e.g. January, Feb.
  • later, someday - Local 9999-12-30, with time 00:00:00. A date far away, with a meaning to GTD users.
  • soy - Local date for the current year, January 1st, with time 00:00:00.
  • eoy - Local date for the current year, December 31st, with time 23:59:59.
  • soq - Local date for the current quarter (January, April, July, October), 1st, with time 00:00:00.
  • eoq - Local date for the end of the current quarter (March, June, September, December), last day of the month, with time 23:59:59.
  • som - Local date for the 1st day of the current month, with time 00:00:00.
  • eom - Local date for the last day of the current month, with time 23:59:59.
  • sow - Local date for the start of the current week, Monday with time 00:00:00.
  • eow - Local date for the end of the current week, Sunday night, with time 23:59:59.
  • soww - Local date for the start of the work week, Monday, with time 00:00:00.
  • eoww - Local date for the end of the work week, Friday night, with time 23:59:59.
  • 1st, 2nd, … - Local date for the next Nth day, with time 00:00:00.
  • goodfriday - Local date for the next Good Friday, with time 00:00:00.
  • easter - Local date for the next Easter Sunday, with time 00:00:00.
  • eastermonday - Local date for the next Easter Monday, with time 00:00:00.
  • ascension - Local date for the next Ascension (39 days after Easter Sunday), with time 00:00:00.
  • pentecost - Local date for the next Pentecost (40 days after Easter Sunday), with time 00:00:00.
  • midsommar - Local date for the Saturday after June 20th, with time 00:00:00. Swedish.
  • midsommarafton - Local date for the Friday after June 19th, with time 00:00:00. Swedish.

For a visual representation of some of the dates look at Named Dates.

The synonyms are supported in addition to rc.dateformat.

Close to every synonym also support including a modifier n for next or p for previous, such as:

  • sonw - Local date for the next Monday, with time 00:00:00.
  • sopw - Local date for the previous Monday, with time 00:00:00.

In order to play around with the dates and to better understand which date is which one can also use task calc to calculate dates.

$ task calc sony

These are useful for quick entry, without writing the full ISO-8601 date. Specifically…

  • 1st, 2nd, … - Local date for the next Nth day, with time 00:00:00.

…which allows one to enter one for a date in that month, such as:

task add +home due:15th beware the ides