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

       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)

timew 1.2.0                                        2020-03-06                                     timew-chart(1)