---
name: "timew-month"
section: "1"
platform: "linux"
package: "timewarrior"
version: "1.4.3+ds.1-2"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/timew-chart"
---

# timew-month(1)

display chart report

Part of [timew-chart(1)](/timew-chart/1.md).

## 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)](/timew-hints/7.md).

**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-day/1.md), [**timew-month**(1)](/timew-month/1.md), [**timew-summary**(1)](/timew-summary/1.md), [**timew-week**(1)](/timew-week/1.md)