Table of Contents

Previous: Deadlines and scheduling, Up: Dates and Times


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-q
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