timew-chart - Man Page

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'.

reports.<type>.day

Determines whether the current day of the month is shown at left margin.
Default value is 'yes'.

reports.<type>.holidays

Determines whether relevant holidays are shown beneath the report.
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'.

reports.<type>.lines

Determines how many lines are used to render each day on the <type> report.
Default value is '1'.

reports.<type>.month

Determines whether the current month is shown at left margin.
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'.

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.

reports.<type>.summary

Determines whether the hours summary is shown.
Default value is 'on'.

reports.<type>.totals

Determines whether the time totals are shown for each day on the report.
Default value is 'on'.

reports.<type>.week

Determines whether the current week number is shown at left margin.
Default value is 'yes'.

reports.<type>.weekday

Determines whether the current weekday is shown at left margin.
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

See Also

timew-day(1), timew-month(1), timew-summary(1), timew-week(1)

Referenced By

timew(1), timew-summary(1).

The man pages timew-day(1), timew-month(1) and timew-week(1) are aliases of timew-chart(1).

2020-04-21 timew 1.3.0 User Manuals