GNU Emacs 32.0.50 (9008bf64c3) のマニュアルを PLaMo 翻訳で機械翻訳したものです。誤訳を含むことがあります。原文: https://www.gnu.org/software/emacs/manual/html_node/emacs/Time-Intervals.html ・ emacs-doc.conao3.com

33.12 時間間隔の合計

timeclockパッケージは時間間隔を累計するため、(例えば)特定のプロジェクトにどれくらいの時間を費やしているかを把握できます。(より高度な代替手段として、Org Modeの時間記録機能を利用する方法もあります。The Org ManualのClocking Work Timeを参照してください)。

プロジェクトに着手する際はM-x timeclock-inコマンドを、完了した際にはM-x timeclock-outコマンドを使用してください。これを行うたびに、プロジェクトの記録に1つのタイムインターバルが追加されます。M-x timeclock-changeを使えば、別のプロジェクトに切り替えることができます。

複数の時間間隔からデータを収集したら、M-x timeclock-workday-remainingを使って本日の残り作業時間(1日平均8時間と想定)を確認でき、M-x timeclock-when-to-leaveを使えば終了時刻を算出できます。

Emacsのモードラインに勤務時間の残り時間を表示させたい場合は、timeclock-mode-line-display変数をカスタマイズしてその値をtに設定するか、M-x timeclock-mode-line-displayコマンドを実行してください。

現在のEmacsセッションを終了することが、プロジェクトでの作業を終えたことを意味する場合もあれば、そうでない場合もあります。デフォルトでは、Emacsは確認を求めます。ただし、変数 timeclock-ask-before-exiting の値を nil にカスタマイズしてこの確認を回避することも可能です。その場合、明示的に M-x timeclock-out または M-x timeclock-change を指定して初めて、現在の区間が終了したことがEmacsに伝わります。

タイムクロック機能は、~/.emacs.d/timelog というファイルにデータを蓄積することで動作します。変数 timeclock-file をカスタマイズすることで、このファイルに別の名前を指定できます。タイムクロックファイルを手動で編集した場合や、タイムクロックのカスタマイズ可能な変数のいずれかの値を変更した場合は、コマンド M-x timeclock-reread-log を実行して、ファイルから Emacs 内のデータを更新してください。