timew-dates(7)

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)