1timew-chart(1) User Manuals timew-chart(1)
2
6 timew-chart - display chart report
7
9 timew day [ <range> ] [ <tag> ... ]
10 timew month [ <range> ] [ <tag> ... ]
11 timew week [ <range> ] [ <tag> ... ]
12
14 A chart summarizes the tracked and untracked time with colored blocks
15 drawn on a timeline. It accepts date ranges and tags for filtering.
16 There are three types: day, week, and month with their respective com‐
17 mands. The reports.<type>.range configuration setting overrides the
18 default date range. For more details, and precise times, use the 'sum‐
19 mary' report.
20 month The month command shows a chart depicting a single month (cur‐
23 rent month by default). The default date range shown is :month.
24 week The week command shows a chart depicting a single week (current
26 week by default). The default date range shown is :week.
27 day The day command shows a chart depicting a single day (today by
29 default). The default date range shown is :day.
30
32 <type> is one of month, week, day.
33 reports.<type>.cell
35 Determines how many minutes are represented by a single charac‐
36 ter cell, for the charts. The value must be greater than '0'.
37 A value of '15' means that an hour is represented by 60/15, or 4
38 character cells. Suitable values are the divisors of 60 (30,
39 20, 15, 12, ...).
40 Default value is '15'.
41 reports.<type>.day
43 Determines whether the current day of the month is shown at left
44 margin.
45 Default value is 'yes'.
46 reports.<type>.holidays
48 Determines whether relevant holidays are shown beneath the re‐
49 port.
50 Default value is 'yes'.
51 reports.<type>.hours
53 Determines how the <type> report shows all the hours in a day
54 ('all'), or is limited to only hours where data is tracked
55 ('auto').
56 Default value is 'all'.
57 reports.<type>.lines
59 Determines how many lines are used to render each day on the
60 <type> report.
61 Default value is '1'.
62 reports.<type>.month
64 Determines whether the current month is shown at left margin.
65 Default value is 'yes'.
66 reports.<type>.range
68 For reports that show a range of data, this setting will over‐
69 ride the default value. The value should be a range hint, see
70 timew-hints(7).
71 reports.<type>.spacing
73 Specifies how many spaces are inserted between the hours in the
74 <type> report exclusions. A value of '0' yields a more compact
75 report.
76 Default value is '1'.
77 reports.<type>.axis
79 The value 'internal' puts the hour markers (time line at the
80 top) inside the exclusion blocks, 'external' puts the hour mark‐
81 ers in a separate line; additional values might be defined in
82 the future.
83 Default is 'internal' for the day report and 'external' for
84 other reports.
85 reports.<type>.summary
87 Determines whether the hours summary is shown.
88 Default value is 'on'.
89 reports.<type>.totals
91 Determines whether the time totals are shown for each day on the
92 report.
93 Default value is 'on'.
94 reports.<type>.week
96 Determines whether the current week number is shown at left mar‐
97 gin.
98 Default value is 'yes'.
99 reports.<type>.weekday
101 Determines whether the current weekday is shown at left margin.
102 Default value is 'yes'.
103
105 :blank The ':blank' hint causes only the excluded time to be shown,
106 with no tracked time. This can be used to see the exclusions.
107 :ids The ':ids' hint causes the intervals to be displayed with their
109 ids
110
112 Charts accept date ranges and tags for filtering, or shortcut hints:
113 $ timew month 1st - today
114 $ timew week FOO BAR
115 $ timew day :week
116
118 timew-day(1), timew-month(1), timew-summary(1), timew-week(1)
119timew 1.4.2 2021-01-27 timew-chart(1)