timewarrior/doc/man7/timew-durations.7.adoc
Thomas Lauf b189ccb020 Replace roff man pages with asciidoctor
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>
2021-02-21 20:58:30 +01:00

60 lines
No EOL
1.4 KiB
Text

= timew-durations(7)
== NAME
timew-durations - duration formats supported by Timewarrior
== SYNOPSIS
== DESCRIPTION
Timewarrior supports the following duration formats based on ISO-8601:
'P' [nn 'Y'] [nn 'M'] [nn 'D'] ['T' [nn 'H'] [nn 'M'] [nn 'S']]
PnnW
Examples:
P1Y 1 year
P1.5M 1.5 months
PT1S 1 second
PT4.5H 4.5 hours
PT4H30M 4.5 hours
P600D 600 days
P3W 3 weeks
P1Y1DT1H1M1S 1 year and 25 hours, 61 seconds (imprecise term)
Note that the year and month terms are imprecise, being defined as 365d and 30d respectively.
For precision use the other terms.
In addition to the standard duration formats, the following are supported:
n[.n]<unit>
Where the <unit> is one of:
annual
biannual
bimonthly
biweekly
biyearly
daily
days, day, d
fortnight
hours, hour, hrs, hr, h
minutes, minute, mins, min
monthly, months, month, mnths, mths, mth, mos, mo, m
quarterly, quarters, quarter, qrtrs, qtr, q
semiannual
sennight
seconds, second, secs, sec, s
weekdays
weekly, weeks, week, wks, wk, w
yearly, years, year, yrs, yr, y
Examples:
1hour 60 minutes
1.5h 90 minutes
3mo 3 months
10d 10 days
Note that the year, quarter and month terms are imprecise, being defined as 365d, 91d and 30d respectively.
For precision use the other terms.