Previous: , 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 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

Previous: , Up: Dates and Times