8.4.1 Clocking commands

C-c C-x C-i (org-clock-in)

为当前条目启动计时(开始计时)。该操作会插入 ‘CLOCK’ 关键字及时间戳。 如果这不是该条目首次计时,多条 ‘CLOCK’ 行会被收纳到 ‘LOGBOOK’ 抽屉中 (另见变量 org-clock-into-drawer )。 你也可以通过为子树设置 ‘CLOCK_INTO_DRAWER’ 或 ‘LOG_INTO_DRAWER’ 属性, 覆盖该变量的设置。 携带 C-u 前缀调用时,从最近计时任务列表中选择任务。 携带两层 C-u C-u 前缀时,为光标处任务计时并将其设为默认任务; 选择计时任务时,默认任务始终可通过按键 d 快速选中。 携带三层 C-u C-u C-u 前缀时,以上一次计时结束时间为起点启动连续计时。

计时运行时,Org 会在模式行显示当前计时时间及任务标题。 显示的计时时间为该任务及其子任务的所有累计计时。 如果任务设有预估耗时(参见 Effort Estimates),模式行会同步显示当前计时与预估耗时的对比75。 若任务为重复任务(参见 Repeated tasks),则只显示任务最近一次重置后的耗时76。 你可以通过 ‘CLOCK_MODELINE_TOTAL’ 属性更精细控制显示的时间, 可选值包括 ‘current’ (仅显示本次计时)、 ‘today’ (显示当日该任务所有计时—另见变量 org-extend-today-until )、 all (显示全部时间)或 auto (默认值)77。 使用 mouse-1 点击模式行中的计时项,会弹出包含计时相关选项的菜单。

C-c C-x C-o (org-clock-out)

停止计时(结束计时)。会在上次计时启动的相同位置插入另一个时间戳, 并直接计算耗时,以 ‘=>HH:MM’ 格式插入在时间区间后。 参见变量 org-log-note-clock-out ,可在结束计时的时间戳旁额外记录备注78

C-c C-x C-x (org-clock-in-last)

为上一个计时任务重新计时。携带一层 C-u 前缀时,从计时历史中选择任务。 携带两层 C-u 前缀时,以上次计时结束时间为起点强制连续计时。

C-c C-x C-e (org-clock-modify-effort-estimate)

更新当前正在计时任务的预估耗时。

C-c C-c or C-c C-y (org-evaluate-time-range)

修改某个时间戳后重新计算时间区间。仅当你直接编辑时间戳时才需要此操作; 若通过 S-<cursor> 按键修改,更新会自动完成。

C-S-UP (org-clock-timestamps-up), C-S-DOWN (org-clock-timestamps-down)

在 ‘CLOCK’ 日志行上,同时增大/减小两个时间戳,保持计时时长不变。

S-M-UP (org-timestamp-up), S-M-DOWN (org-timestamp-down)

在 ‘CLOCK’ 日志行上,将光标处时间戳与上一条或下一条计时时间戳同步增减相同时长。 例如,按下 S-M-UP 将结束计时时间戳增加五分钟,下一条计时的开始时间戳也会同步增加五分钟。

调整前后时间戳时,仅考虑当前 Emacs 会话中创建的 ‘CLOCK’ 日志。

C-c C-t (org-todo)

将条目的 TODO 状态改为 DONE 时,若该条目正在计时,会自动停止。

C-c C-x C-q (org-clock-cancel)

取消当前计时。适用于误启动计时或最终处理了其他任务的场景。

C-c C-x C-j (org-clock-goto)

跳转到当前正在计时任务的标题。携带 C-u 前缀时,从最近计时任务列表中选择目标任务。

C-c C-x C-d (org-clock-display)

在当前缓冲区显示每个子树的时间汇总。会在每个标题末尾添加覆盖层, 显示该标题下记录的总时间(包含所有子标题时间)。 你可以使用可见性循环查看结构,但修改缓冲区(参见变量 org-remove-highlights-with-change ) 或按下 C-c C-c 后覆盖层会消失。

在日程表中(参见 Weekly/daily agenda)可使用 l 键, 查看当日处理或完成的任务。

重要: 注意 org-clock-outorg-clock-in-last 均可设置全局按键绑定,且不会改变窗口布局。


Footnotes

(75)

如需 “即时(on the fly)” 添加预估耗时,可将实现该功能的函数挂入 org-clock-in-prepare-hook

(76)

任务最近一次重置时间由 ‘LAST_REPEAT’ 属性记录。

(77)

另见变量 org-clock-mode-line-total

(78)

对应的缓冲区内设置为: ‘#+STARTUP: lognoteclock-out’ 。