1TIMEW-DATES(7) User Manuals TIMEW-DATES(7)
2
6 timew-dates - date formats supported by Timewarrior
7
10 Timewarrior supports the following datetime formats based on ISO-8601.
11 If times are followed by a 'Z', they are assumed to be in UTC,
12 otherwise local time (TZ) is assumed.
13 <extended-date> [T <extended-time>] Extended date, optional extended time
15 <date> [T <time>] Date, optional time
16 <extended-time> Extended time
17 <time> Time
18 extended-date
20 YYYY-MM-DD Year, month, day
22 YYYY-MM Year, month, 1st
23 YYYY-DDD Year, Julian day 001-366
24 YYYY-WwwD Year, week number, day number
25 YYYY-Www Year, week number, day 1
26 extended-time
28 hh:mm[:ss]Z Hours, minutes, optional seconds, UTC
30 hh:mm[:ss][+/-hh:mm] Hours, minutes, optional seconds, TZ
31 date
33 YYYYMMDD Year, month, day
35 YYYYWww Year, week number, day number
36 YYYYDDD Year, Julian day 001-366
37 time
39 hhmm[ss]Z Hour, minutes, optional seconds, UTC
41 hhmm[ss][+/-hh[mm]] Hour, minutes, optional seconds, TZ
42
44 Here are some examples for ISO datetimes:
45 2016-06-09T08:12:00Z
47 2016-06T08:12:00+01:00
48 2016-06T08:12Z
49 2016-161
50 2016-W244
51 2016-W24
52 20160609T081200Z
53 2016W24
54 8:12:00Z
55 0812-0500
56 In addition to the standard date formats, the following named dates are
58 supported:
59 now Current date and time
61 today Current date at 0:00:00
62 yesterday Yesterday at 0:00:00
63 tomorrow Tomorrow at 0:00:00 (midnight tonight)
64 <day-of-week> Previous named day at 0:00:00
65 <month-of-year> Previous 1st of the month at 0:00:00
66 hh:mm[:ss][am|a|pm|p] Short time format
67 Nst, Nnd, Nrd, Nth Previous 1st, 2nd, 3rd ...
68 <epoch> POSIX time (at least 315532800)
69 later 2038-01-18T0:00:00 (Y2K38)
70 someday 2038-01-18T0:00:00 (Y2K38)
71 sopd, eopd Start/end of previous day
72 sod, eod Start/end of current day
73 sond, eond Start/end of next day
74 sopw, eopw Start/end of previous week
75 sow, eow Start/end of current week
76 sonw, eonw Start/end of next week
77 sopww, eopww Start/end of previous work week (mon - fri)
78 soww, eoww Start/end of current work week (mon - fri)
79 sonww, eonww Start/end of next work week (mon - fri)
80 sopm, eopm Start/end of previous month
81 som, eom Start/end of current month
82 sonm, eonm Start/end of next month
83 sopq, eopq Start/end of previous quarter
84 soq, eoq Start/end of current quarter
85 sonq, eonq Start/end of next quarter
86 sopy, eopy Start/end of previous year
87 soy, eoy Start/end of current year
88 sony, eony Start/end of next year
89 easter Easter Sunday
90 eastermonday Easter Monday
91 ascension Ascension
92 pentecost Pentecost
93 goodfriday Good Friday
94 midsommar midnight, 1st Saturday after 20th June
95 midsommarafton midnight, 1st Friday after 19th June
96 juhannus midnight, 1st Friday after 19th June
97 For times, the following are also possible:
99 8am
101 24th
102 monday
103 august
104
106 The minimum value for the POSIX time format of 315532800 (that is
107 1980-01-01) was chosen to avoid confusion with ISO dates in the
108 YYYYMMDD format.
109 Because named dates are defined with time 0:00:00, using them as range
111 end excludes the respective day. E.g. using 'today' as upper range
112 $ timew sum 2d before today
114 will not show any intervals of the current day. Use either 'now' or
116 'tomorrow' in this case:
117 $ timew sum 2d before now
119 $ timew sum 2d before tomorrow
120
122 timew-durations(7), timew-hints(7)
123timew 1.6.0 2023-09-18 TIMEW-DATES(7)