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
17 commands. The reports.<type>.range configuration setting overrides the
18 default date range. For more details, and precise times, use the
19 'summary' report.
20 month
22 The month command shows a chart depicting a single month (current
23 month by default). The default date range shown is :month.
24 week
26 The week command shows a chart depicting a single week (current
27 week by default). The default date range shown is :week.
28 day
30 The day command shows a chart depicting a single day (today by
31 default). The default date range shown is :day.
32
34 <type> is one of month, week, day.
35 reports.<type>.cell
37 Determines how many minutes are represented by a single character
38 cell, for the charts. The value must be greater than '0'. A value
39 of '15' means that an hour is represented by 60/15, or 4 character
40 cells. Suitable values are the divisors of 60 (30, 20, 15, 12,
41 ...). Default value is '15'.
42 reports.<type>.day
44 Determines whether the current day of the month is shown at left
45 margin. Default value is 'yes'.
46 reports.<type>.holidays
48 Determines whether relevant holidays are shown beneath the report.
49 Default value is 'yes'.
50 reports.<type>.hours
52 Determines how the <type> report shows all the hours in a day
53 ('all'), or is limited to only hours where data is tracked
54 ('auto'). Default value is 'all'.
55 reports.<type>.lines
57 Determines how many lines are used to render each day on the <type>
58 report. Default value is '1'.
59 reports.<type>.month
61 Determines whether the current month is shown at left margin.
62 Default value is 'yes'.
63 reports.<type>.range
65 For reports that show a range of data, this setting will override
66 the default value. The value should be a range hint, see
67 timew-hints(7).
68 reports.<type>.spacing
70 Specifies how many spaces are inserted between the hours in the
71 <type> report exclusions. A value of '0' yields a more compact
72 report. Default value is '1'.
73 reports.<type>.axis
75 The value 'internal' puts the hour markers (time line at the top)
76 inside the exclusion blocks, 'external' puts the hour markers in a
77 separate line; additional values might be defined in the future.
78 Default is 'internal' for the day report and 'external' for other
79 reports.
80 reports.<type>.summary
82 Determines whether the hours summary is shown. Default value is
83 'on'.
84 reports.<type>.totals
86 Determines whether the time totals are shown for each day on the
87 report. Default value is 'on'.
88 reports.<type>.week
90 Determines whether the current week number is shown at left margin.
91 Default value is 'yes'.
92 reports.<type>.weekday
94 Determines whether the current weekday is shown at left margin.
95 Default value is 'yes'.
96
98 :blank
99 The ':blank' hint causes only the excluded time to be shown, with
100 no tracked time. This can be used to see the exclusions.
101 :ids
103 The ':ids' hint causes the intervals to be displayed with their ids
104
106 Charts accept date ranges and tags for filtering, or shortcut hints:
107 $ timew month 1st - today
109 $ timew week FOO BAR
110 $ timew day :week
111
113 timew-day(1), timew-month(1), timew-summary(1), timew-week(1)
114timew 1.4.3 2021-05-16 TIMEW-CHART(1)