Today Command

View the output of tt today --help

track-time-cli today [sheets..]

Display a summary of activity for today

Options:
      --version          Show version number                    [boolean]
      --absolute, --abs  Print dates as absolute timestamps     [boolean]
  -h, --humanize         Print the total duration in human-readable format
                                                                [boolean]
      --all-sheets       Show results for all sheets            [boolean]
      --help             Show help                              [boolean]
      --sheets           Show results for the specified sheets  [array]

The today command is used to display a summary of activity for the current day. Multiple sheets can be included in the output; by default only the active sheet will be used.

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 dates as absolute ISO timestamps with --absolute

tip

The --absolute (or --abs) argument enables rendering of dates as ISO timestamps instead of relative times.

argument	alias	type	description	default
--absolute	--abs	boolean	Print dates as absolute timestamps	false
--humanize	-h	boolean	Print the durations in a human-readable format	false
--all-sheets		boolean	Include all sheets in the results	false
--sheets		string	Specify the sheets that will be included in the results	false

Examples

A few simple examples are provided below.

View A Summary of Activity From All Sheets For Today

Often, you will want to see a summary of the day's activity across all sheets. To do this, provide the --all-sheets argument. Otherwise, you can select sheets with the --sheets argument. For exanple:

Select Individual Sheets

Pass sheet names via the --sheets argument to include them in the results:

View Durations As Human-Readable Words

Render durations in a human-readable format with the -h (or --humanize) argument:

Display Absolute Dates

Instead of exposing a -r (or --relative) argument, the today command displays dates as relative by default. To switch to displaying dates as absolute timestamps, pass the --absolute (or --abs) argument: