8.4 Clocking work time
Org mode allows you to clock the time you spend on specific tasks in a
project.
- C-c C-x C-i
- Start the clock on the current item (clock-in). This inserts the CLOCK
keyword together with a timestamp. When called with a C-u prefix
argument, select the task from a list of recently clocked tasks.
- C-c C-x C-o
- Stop the clock (clock-out). This inserts another timestamp at the same
location where the clock was last started. It also directly computes
the resulting time in inserts it after the time range as ‘=>
HH:MM’.
- C-c C-x C-e
- Update the effort estimate for the current clock task.
- C-c C-x C-x
- Cancel the current clock. This is useful if a clock was started by
mistake, or if you ended up working on something else.
- C-c C-x C-j
- Jump to the entry that contains the currently running clock. With a
C-u prefix arg, select the target task from a list of recently clocked
tasks.
- C-c C-x C-r
- Insert a dynamic block containing a clock
report as an Org-mode table into the current file. When the cursor is
at an existing clock table, just update it.
#+BEGIN: clocktable :maxlevel 2 :emphasize nil :scope file
#+END: clocktable
For details about how to customize this view, see the manual.
- C-c C-c
- Update dynamic block at point. The cursor needs to be in the
#+BEGIN line of the dynamic block.
The l key may be used in the timeline (see Timeline) and in
the agenda (see Weekly/daily agenda) to show which tasks have been
worked on or closed during a day.
Further reading
Chapter 8 of the manual
Charles Cave's Date and Time tutorial
Bernt Hansen's clocking workflow