GothenburgBitFactory/timewarrior
1
0
Fork 0
mirror of https://github.com/GothenburgBitFactory/timewarrior.git synced 2025-07-07 20:06:39 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Extract documentation about dates into separate man page

Browse source 
Signed-off-by: Thomas Lauf <thomas.lauf@tngtech.com>
This commit is contained in:
Thomas Lauf 2019-02-15 14:08:53 +01:00
parent 94ac7bd58a
commit 27cf2e0ef2
2 changed files with 88 additions and 88 deletions
Download patch file Download diff file Expand all files Collapse all files

88
doc/man/timew-dates.7.in Normal file
View file

@ -0,0 +1,88 @@
.SH DATES
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
.br
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
.br
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
.br
Examples:
8am
24th
monday
august
.br
See also 'duration', 'hints'.
.

88
doc/man/timew.1.in
View file

@ -202,94 +202,6 @@ Examples are:
.br
An interval is said to be 'closed' if there is both a start and end, and 'open' if there is no end date.
.
.SH DATES
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
.br
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
.br
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
.br
Examples:
8am
24th
monday
august
.br
See also 'duration', 'hints'.
.
.SH "MORE EXAMPLES"
.
For examples please see the online documentation starting at: