NAME

       timew-dom - Timewarrior DOM

SYNOPSIS

DESCRIPTION

       All DOM references start with dom, there are 4 subreferences that can be accessed:

       •   dom.tracked, all intervals

       •   dom.active, active time tracking

       •   dom.tags, all tags

       •   dom.rc, configuration settings

           All intervals
               dom.tracked is a reference to all intervals of the database query result. When using this
               reference, filtering by range and tags can be applied.

                   dom.tracked.count           Count of all intervals in the query result
                   dom.tracked.ids             Ids of all intervals in the query result
                   dom.tracked.tags            Tags of all intervals in the query result
                   dom.tracked.tags.count      Count of all tags in the query result
                   dom.tracked.tags.<n>        N-th Tag of all tags in the query result

               dom.tracked.<n> is a reference to the n-th interval of the database query result. Depending on
               the filtering applied, the n-th interval is not necessarily the one with ID @n!

                   dom.tracked.<n>.tags        All tags of the n-th interval
                   dom.tracked.<n>.tags.count  Count of tags of the n-th interval
                   dom.tracked.<n>.tags.<m>    N-th interval, m-th tag
                   dom.tracked.<n>.start       N-th interval, start time (ISO Extended date)
                   dom.tracked.<n>.end         N-th interval, end time (ISO Extended date, blank if open)
                   dom.tracked.<n>.duration    N-th interval, duration (ISO Duration)
                   dom.tracked.<n>.json        N-th interval, as JSON

           Active time tracking
               dom.active is a reference to the latest interval in active time tracking. It is invalid when no
               time is tracked.

                   dom.active                  '1' if there is active tracking, otherwise '0'
                   dom.active.tags             All tags of the active tracking
                   dom.active.tags.count       Count of tags
                   dom.active.tags.<n>         N-th tag
                   dom.active.start            Start timestamp (ISO Extended date)
                   dom.active.duration         Elapsed (ISO Period)
                   dom.active.json             Interval as JSON

           All tags
               dom.tags is a reference to all tags in the database.

                   dom.tags                    All tags
                   dom.tags.count              Count of all tags
                   dom.tags.1                  N-th tag

               Without filtering applied, dom.tracked.tags refers to the same set of tags as dom.tags.

           Configuration settings
               dom.rc is a reference to all Timewarrior configuration settings. As there are no restrictions for
               the configuration keys, all those references are valid by design.

                   dom.rc.<name>              Configuration setting <name>

timew 1.9.1                                        2025-11-02                                       TIMEW-DOM(7)