timew-chart(1)
| timew-chart(1) | User Manuals | timew-chart(1) |
NAME
timew-chart - display chart report
SYNOPSIS
timew day [ <range> ] [ <tag>
... ]
timew month [ <range> ] [ <tag> ... ]
timew week [ <range> ] [ <tag> ...
]
DESCRIPTION
A chart summarizes the tracked and untracked time with colored blocks drawn on a timeline. It accepts date ranges and tags for filtering. There are three types: day, week, and month with their respective commands. The reports.<type>.range configuration setting overrides the default date range. For more details, and precise times, use the 'summary' report.
- month
- The month command shows a chart depicting a single month (current month by default). The default date range shown is :month.
- week
- The week command shows a chart depicting a single week (current week by default). The default date range shown is :week.
- day
- The day command shows a chart depicting a single day (today by default). The default date range shown is :day.
CONFIGURATION
<type> is one of month, week, day.
- reports.<type>.cell
Determines how many minutes are represented by a single
character cell, for the charts. The value must be greater than '0'. A value of
'15' means that an hour is represented by 60/15, or 4 character cells.
Suitable values are the divisors of 60 (30, 20, 15, 12, ...).
Default value is '15'.
Default value is '15'.
- reports.<type>.day
Determines whether the current day of the month is shown
at left margin.
Default value is 'yes'.
Default value is 'yes'.
- reports.<type>.holidays
Determines whether relevant holidays are shown beneath
the report.
Default value is 'yes'.
Default value is 'yes'.
- reports.<type>.hours
Determines how the <type> report shows all the
hours in a day ('all'), or is limited to only hours where data is tracked
('auto').
Default value is 'all'.
Default value is 'all'.
- reports.<type>.lines
Determines how many lines are used to render each day on
the <type> report.
Default value is '1'.
Default value is '1'.
- reports.<type>.month
Determines whether the current month is shown at left
margin.
Default value is 'yes'.
Default value is 'yes'.
- reports.<type>.range
For reports that show a range of data, this setting will
override the default value. The value should be a range hint, see
timew-hints(7).
- reports.<type>.spacing
Specifies how many spaces are inserted between the hours
in the <type> report exclusions. A value of '0' yields a more compact
report.
Default value is '1'.
Default value is '1'.
- reports.<type>.axis
The value 'internal' puts the hour markers (time line at
the top) inside the exclusion blocks, 'external' puts the hour markers in a
separate line; additional values might be defined in the future.
Default is 'internal' for the day report and 'external' for other reports.
Default is 'internal' for the day report and 'external' for other reports.
- reports.<type>.summary
Determines whether the hours summary is shown.
Default value is 'on'.
Default value is 'on'.
- reports.<type>.totals
Determines whether the time totals are shown for each day
on the report.
Default value is 'on'.
Default value is 'on'.
- reports.<type>.week
Determines whether the current week number is shown at
left margin.
Default value is 'yes'.
Default value is 'yes'.
- reports.<type>.weekday
Determines whether the current weekday is shown at left
margin.
Default value is 'yes'.
Default value is 'yes'.
HINTS
- :blank
- The ':blank' hint causes only the excluded time to be shown, with no tracked time. This can be used to see the exclusions.
- :ids
- The ':ids' hint causes the intervals to be displayed with their ids
EXAMPLES
Charts accept date ranges and tags for filtering, or shortcut hints:
$ timew month 1st - today
$ timew week FOO BAR
$ timew day :week
$ timew week FOO BAR
$ timew day :week
SEE ALSO
timew-day(1), timew-month(1), timew-summary(1), timew-week(1)
| 2020-03-08 | timew 1.2.0 |