= 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)
