Breakdown Command

View the output of tt breakdown --help

track-time-cli breakdown [sheets..]

Display total durations per day for one or more sheets

Options:
      --version          Show version number                            [boolean]
      --all-sheets       Show results for all sheets                    [boolean]
  -r, --ago, --relative  Print dates as relative time (e.g. 5 minutes ago)
                                                                        [boolean]
  -h, --humanize         Print the total duration in human-readable format
                                                                        [boolean]
  -s, --since            Only list entries since the specified date     [string]
      --help             Show help                                      [boolean]

The breakdown command, or b for short, displays total time logged by the day, day of the week, and hour.

Provide one or more sheet names to include them in the results. The usual -h and -r are available.

Arguments

Render durations into a human-readable word form with --humanize

tip

The -h (or --humanize) argument switches the rendering of durations from a simple digit display to a human-readable word form.

Render start and end dates as relative to the present moment with --relative

tip

The -r (or --relative) argument enables the rendering of dates as relative to the present moment. For example, the output for an entry's start date may be 2 weeks ago when using this flag.

Natural language input with --since

tip

Natural language input is supported by the --since argument.

For example, all of the following are valid:

• --since '12 hours ago'
• --since '30 days ago'
• --since 'one year ago'

The time-speak library is used to parse the input.

argument	alias	type	description	default
--humanize	-h	boolean	Renders durations in human-readable format	false
--since	-s	string	Only lists entries since the specified date; supports natural language input.
--all-sheets		boolean	Show results for all sheets	false
--relative	ago, -r	boolean	Print dates as relative time (e.g. "5 minutes ago").
--sheets		array	Show results for the specified sheets. Also a positional argument.

Examples

Below you can find many examples showcasing the various arguments and how you can use them to filter output and control rendering.

TODO

Examples pending