NAME

timew-dates - date formats supported by Timewarrior

SYNOPSIS

DESCRIPTION

Timewarrior supports the following date formats based on ISO-8601:

<extended-date> [T <extended-time>] Extended date, optional extended time
<date> [T <time>]                   Date, optional time
<extended-time>                     Extended time
<time>                              Time

extended-date:

YYYY-MM-DD Year, month, day
YYYY-MM    Year, month, 1st
YYYY-DDD   Year, Julian day 001-366
YYYY-WwwD  Year, week number, day number
YYYY-Www   Year, week number, day 1

extended-time:

hh:mm[:ss]Z          Hours, minutes, optional seconds, UTC
hh:mm[:ss][+/-hh:mm] Hours, minutes, optional seconds, TZ

date:

YYYYMMDD Year, month, day
YYYYWww  Year, week number, day number
YYYYDDD  Year, Julian day 001-366

time:

hhmm[ss]Z           Hour, minutes, optional seconds, UTC
hhmm[ss][+/-hh[mm]] Hour, minutes, optional seconds, TZ

Examples:

2016-06-09T08:12:00Z
2016-06T08:12:00+01:00
2016-06T08:12Z
2016-161
2016-W244
2016-W24
20160609T081200Z
2016W24
8:12:00Z
0812-0500

In addition to the standard date formats, the following are supported:


now                   Current date and time
today                 Current date at 0:00:00
yesterday             Yesterday at 0:00:00
tomorrow              Tomorrow at 0:00:00 (midnight tonight)
<day-of-week>         Previous named day at 0:00:00
<month-of-year>       Previous 1st of the month at 0:00:00
hh:mm[:ss][am|a|pm|p] Short time format
Nst, Nnd, Nrd, Nth    Previous 1st, 2nd, 3rd ...
<epoch>               POSIX time
later                 2038-01-18T0:00:00 (Y2K38)
someday               2038-01-18T0:00:00 (Y2K38)
sopd, eopd            Start/end of previous day
sod, eod              Start/end of current day
sond, eond            Start/end of next day
sopw, eopw            Start/end of previous week
sow, eow              Start/end of current week
sonw, eonw            Start/end of next week
sopww, eopww          Start/end of previous work week (mon - fri)
soww, eoww            Start/end of current work week (mon - fri)
sonww, eonww          Start/end of next work week (mon - fri)
sopm, eopm            Start/end of previous month
som, eom              Start/end of current month
sonm, eonm            Start/end of next month
sopq, eopq            Start/end of previous quarter
soq, eoq              Start/end of current quarter
sonq, eonq            Start/end of next quarter
sopy, eopy            Start/end of previous year
soy, eoy              Start/end of current year
sony, eony            Start/end of next year
easter                Easter Sunday
eastermonday          Easter Monday
ascension             Ascension
pentecost             Pentecost
goodfriday            Good Friday
midsommar             midnight, 1st Saturday after 20th June
midsommarafton        midnight, 1st Friday after 19th June
juhannus              midnight, 1st Friday after 19th June

Examples:

8am
24th
monday
august

SEE ALSO

timew-durations(7), timew-hints(7)