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 点击模式行中的计时项,会弹出包含计时相关选项的菜单。
org-clock-out) ¶停止计时(结束计时)。会在上次计时启动的相同位置插入另一个时间戳,
并直接计算耗时,以 ‘=>HH:MM’ 格式插入在时间区间后。
参见变量 org-log-note-clock-out ,可在结束计时的时间戳旁额外记录备注78。
org-clock-in-last) ¶为上一个计时任务重新计时。携带一层 C-u 前缀时,从计时历史中选择任务。 携带两层 C-u 前缀时,以上次计时结束时间为起点强制连续计时。
org-clock-modify-effort-estimate) ¶更新当前正在计时任务的预估耗时。
org-evaluate-time-range) ¶修改某个时间戳后重新计算时间区间。仅当你直接编辑时间戳时才需要此操作; 若通过 S-<cursor> 按键修改,更新会自动完成。
org-clock-timestamps-up), C-S-DOWN (org-clock-timestamps-down) ¶在 ‘CLOCK’ 日志行上,同时增大/减小两个时间戳,保持计时时长不变。
org-timestamp-up), S-M-DOWN (org-timestamp-down) ¶在 ‘CLOCK’ 日志行上,将光标处时间戳与上一条或下一条计时时间戳同步增减相同时长。 例如,按下 S-M-UP 将结束计时时间戳增加五分钟,下一条计时的开始时间戳也会同步增加五分钟。
调整前后时间戳时,仅考虑当前 Emacs 会话中创建的 ‘CLOCK’ 日志。
org-todo) ¶将条目的 TODO 状态改为 DONE 时,若该条目正在计时,会自动停止。
org-clock-cancel) ¶取消当前计时。适用于误启动计时或最终处理了其他任务的场景。
org-clock-goto) ¶跳转到当前正在计时任务的标题。携带 C-u 前缀时,从最近计时任务列表中选择目标任务。
org-clock-display) ¶在当前缓冲区显示每个子树的时间汇总。会在每个标题末尾添加覆盖层,
显示该标题下记录的总时间(包含所有子标题时间)。
你可以使用可见性循环查看结构,但修改缓冲区(参见变量 org-remove-highlights-with-change )
或按下 C-c C-c 后覆盖层会消失。
在日程表中(参见 Weekly/daily agenda)可使用 l 键, 查看当日处理或完成的任务。
重要: 注意 org-clock-out 和 org-clock-in-last 均可设置全局按键绑定,且不会改变窗口布局。
如需 “即时(on the fly)” 添加预估耗时,可将实现该功能的函数挂入 org-clock-in-prepare-hook 。
任务最近一次重置时间由 ‘LAST_REPEAT’ 属性记录。
另见变量 org-clock-mode-line-total 。
对应的缓冲区内设置为: ‘#+STARTUP: lognoteclock-out’ 。