timew-export - Man Page

export tracked time in JSON

Synopsis

timew export [ <id>... | ([<range>] [<tag>...]) ]

Description

Exports all the tracked time in JSON format.

Supply either a list of interval IDs, or a range and/or tag filter (see timew-ranges(7) and timew-tags(1)) to export only a subset of intervals.

The data is exported as a JSON array of interval objects, each containing the start time, end time, current id, tags, and annotation of the interval, if present.

Examples

Export all intervals

Calling the export command without any arguments exports all tracked intervals in JSON format:

$ timew export
[
{"id":2,"start":"20231001T103000Z","end":"20231001T120000Z","tags":["work"],"annotation":"Project work"},
{"id":1,"start":"20231001T090000Z","end":"20231001T100000Z","tags":["work"],"annotation":"Morning meeting"},
]

In this example, only two intervals are present in the database. The output is sorted by start time, with the oldest interval first.

Export intervals filtered by range and tag

$ timew export from 2016-01-01 for 3wks tag1
...

Export intervals by their ids

$ timew export @1 @3 @7
...

Referenced By

timew(1), timew-annotate(1), timew-import(1).

2025-08-16 timew 1.9.0 User Manuals