1. timr-report(1)
  2. Timr Manual
  3. timr-report(1)

NAME

timr-report - Export Tasks and Tracks.

SYNOPSIS

timr report [options]

DESCRIPTION

This command is designed to print a list of Tasks or Tracks to STDOUT and to export Tasks and Tracks as CSV files. While this command is similar to timr-log(1), the main focus is exporting Tasks/Tracks as CSV file for further processing.

OPTIONS

-d, --day date

A single day from 00:00 to 23:59. See timr-ftime(7).

-m, --month [YYYY-]MM

A single month from 01 to 31.

-y, --year [YYYY]

A single year from 01-01 to 12-31.

-a, --all

Export all.

--tasks

Export Tasks (default)

--tracks

Export Tracks

--billed

Filter only Tasks/Tracks which are billed.

--unbilled

Filter only Tasks/Tracks which are not billed.

--format

See TASK FORMAT and TRACK FORMAT section.

--csv path

Export as CSV file. Use --csv - to use STDOUT.

--force

Force overwrite file.

-h, --help

Displays the help page.

EXAMPLES

timr report
timr report --day 2017-01-02
timr report --day 2017-01-02 --csv timr_report_20170102.csv
timr report --day 2017-01-02 --csv timr_report_20170102.csv --tracks
timr report --month 2017-01 --csv timr_report_201701.csv
timr report --year 2017 --csv timr_report_2017.csv
timr report --all --csv timr_report_all.csv
timr report --format '- %id'
timr report --tracks --format '- %Tsid %sid %t'
timr report --tracks --all --billed
timr report --tracks --all --unbilled
timr report --tasks --all
timr report --tasks --all --billed
timr report --tasks --all --unbilled

TASK TABLE COLUMNS

START

Task Start Date

END

Task End Date

DUR

Total Task Duration

UNB

Unbilled Task Duration

TASK

Task ID and Name.

TRACK TABLE COLUMNS

START

Task Start Date

END

Task End Date

DUR

Task Duration

TASK

Task ID

TRACK

Track ID and Name.

TASK CSV COLUMNS

TRACK CSV COLUMNS

The last row in CSV files is always the total sum.

TASK FORMAT

%id

ID

%sid

Short ID

%fid

Foreign ID

%n

Name

%d

Description

%ds

Duration Seconds

%dh

Duration Human Format

TRACK FORMAT

%id

ID

%sid

Short ID

%t

Title generated from message.

%m

Message

%bdt

Begin DateTime

%bd

Begin Date

%bt

Begin Time

%edt

End DateTime

%ed

End Date

%et

End Time

%ds

Duration Seconds

%dh

Duration Human Format

%bi

Billed Integer

%bh

Billed Human Format (YES, NO)

Use %T prefix for each Task attribute for Track formatting. For example use %Tid to use the Task ID.

API REFERENCE

https://timr.fox21.at/api/TheFox/Timr/Command/ReportCommand.html

SEE ALSO

timr-log(1), timr-ftime(7)

TIMR

This is part of timr(1).

  1. FOX21.at
  2. April 2017
  3. timr-report(1)