1timew-chart(1)                   User Manuals                   timew-chart(1)
2
3
4

NAME

6       timew-chart - display chart report
7

SYNOPSIS

9       timew day [ <range> ] [ <tag> ...  ]
10       timew month [ <range> ] [ <tag> ...  ]
11       timew week [ <range> ] [ <tag> ...  ]
12

DESCRIPTION

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
21
22       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
25       week   The  week command shows a chart depicting a single week (current
26              week by default).  The default date range shown is :week.
27
28       day    The day command shows a chart depicting a single day  (today  by
29              default).  The default date range shown is :day.
30

CONFIGURATION

32       <type> is one of month, week, day.
33
34       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
42       reports.<type>.day
43              Determines whether the current day of the month is shown at left
44              margin.
45              Default value is 'yes'.
46
47       reports.<type>.holidays
48              Determines whether relevant holidays are shown beneath  the  re‐
49              port.
50              Default value is 'yes'.
51
52       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
58       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
63       reports.<type>.month
64              Determines whether the current month is shown at left margin.
65              Default value is 'yes'.
66
67       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
72       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
78       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
86       reports.<type>.summary
87              Determines whether the hours summary is shown.
88              Default value is 'on'.
89
90       reports.<type>.totals
91              Determines whether the time totals are shown for each day on the
92              report.
93              Default value is 'on'.
94
95       reports.<type>.week
96              Determines whether the current week number is shown at left mar‐
97              gin.
98              Default value is 'yes'.
99
100       reports.<type>.weekday
101              Determines whether the current weekday is shown at left margin.
102              Default value is 'yes'.
103

HINTS

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
108       :ids   The  ':ids' hint causes the intervals to be displayed with their
109              ids
110

EXAMPLES

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

SEE ALSO

118       timew-day(1), timew-month(1), timew-summary(1), timew-week(1)
119
120
121
122timew 1.4.2                       2021-01-27                    timew-chart(1)
Impressum