mirror of
https://github.com/GothenburgBitFactory/timewarrior.git
synced 2025-06-26 10:54:28 +02:00
b189ccb020
This replaces the generation of man pages on project setup by a on-demand generation via asciidoctor. An exception are the man pages for the commands `day`, `month`, and `week` which are simply redirects to the man page `timew-chart.1`. Those are now static files in the Timewarrior repository. A CMake find module to detect asciidoctor was added. If asciidoctor is found, the targets `doc`, `man1`, and `man7` are created. Those targets are also added to the default build target. If asciidoctor is not available, the target `doc` is available, but it only emits a message to install asciidoctor first. Signed-off-by: Thomas Lauf <thomas.lauf@tngtech.com>
103 lines
4 KiB
Text
103 lines
4 KiB
Text
= 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)
|