1TIMEW-DATES(7)                   User Manuals                   TIMEW-DATES(7)
2
3
4

NAME

6       timew-dates - date formats supported by Timewarrior
7

SYNOPSIS

DESCRIPTION

10       Timewarrior supports the following date formats based on ISO-8601:
11
12           <extended-date> [T <extended-time>]   Extended date, optional extended time
13           <date> [T <time>]                     Date, optional time
14           <extended-time>                       Extended time
15           <time>                                Time
16
17       extended-date
18
19               YYYY-MM-DD                          Year, month, day
20               YYYY-MM                             Year, month, 1st
21               YYYY-DDD                            Year, Julian day 001-366
22               YYYY-WwwD                           Year, week number, day number
23               YYYY-Www                            Year, week number, day 1
24
25       extended-time
26
27               hh:mm[:ss]Z                         Hours, minutes, optional seconds, UTC
28               hh:mm[:ss][+/-hh:mm]                Hours, minutes, optional seconds, TZ
29
30       date
31
32               YYYYMMDD                            Year, month, day
33               YYYYWww                             Year, week number, day number
34               YYYYDDD                             Year, Julian day 001-366
35
36       time
37
38               hhmm[ss]Z                           Hour, minutes, optional seconds, UTC
39               hhmm[ss][+/-hh[mm]]                 Hour, minutes, optional seconds, TZ
40
41       Examples:
42
43           2016-06-09T08:12:00Z
44           2016-06T08:12:00+01:00
45           2016-06T08:12Z
46           2016-161
47           2016-W244
48           2016-W24
49           20160609T081200Z
50           2016W24
51           8:12:00Z
52           0812-0500
53
54       In addition to the standard date formats, the following are supported:
55
56           now                                   Current date and time
57           today                                 Current date at 0:00:00
58           yesterday                             Yesterday at 0:00:00
59           tomorrow                              Tomorrow at 0:00:00 (midnight tonight)
60           <day-of-week>                         Previous named day at 0:00:00
61           <month-of-year>                       Previous 1st of the  month at 0:00:00
62           hh:mm[:ss][am|a|pm|p]                 Short time format
63           Nst, Nnd, Nrd, Nth                    Previous 1st, 2nd, 3rd ...
64           <epoch>                               POSIX time
65           later                                 2038-01-18T0:00:00 (Y2K38)
66           someday                               2038-01-18T0:00:00 (Y2K38)
67           sopd, eopd                            Start/end of previous day
68           sod, eod                              Start/end of current day
69           sond, eond                            Start/end of next day
70           sopw, eopw                            Start/end of previous week
71           sow, eow                              Start/end of current week
72           sonw, eonw                            Start/end of next week
73           sopww, eopww                          Start/end of previous work week (mon - fri)
74           soww, eoww                            Start/end of current work week (mon - fri)
75           sonww, eonww                          Start/end of next work week (mon - fri)
76           sopm, eopm                            Start/end of previous month
77           som, eom                              Start/end of current month
78           sonm, eonm                            Start/end of next month
79           sopq, eopq                            Start/end of previous quarter
80           soq, eoq                              Start/end of current quarter
81           sonq, eonq                            Start/end of next quarter
82           sopy, eopy                            Start/end of previous year
83           soy, eoy                              Start/end of current year
84           sony, eony                            Start/end of next year
85           easter                                Easter Sunday
86           eastermonday                          Easter Monday
87           ascension                             Ascension
88           pentecost                             Pentecost
89           goodfriday                            Good Friday
90           midsommar                             midnight, 1st Saturday after 20th June
91           midsommarafton                        midnight, 1st Friday after 19th June
92           juhannus                              midnight, 1st Friday after 19th June
93
94       Examples:
95
96           8am
97           24th
98           monday
99           august
100

SEE ALSO

102       timew-durations(7), timew-hints(7)
103
104
105
106timew 1.4.3                       2021-05-16                    TIMEW-DATES(7)