NAME

       Timeclock - the time logging format of timeclock.el, as read by hledger

DESCRIPTION

       hledger  can  read  timeclock  files.   As  with  Ledger,  these are (a subset of) timeclock.el's format,
       containing clock-in and clock-out entries as in the example below.  The date is a simple date.  The  time
       format is HH:MM[:SS][+-ZZZZ].  Seconds and timezone are optional.  The timezone, if present, must be four
       digits and is ignored (currently the time is always interpreted as a local time).

              i 2015/03/30 09:00:00 some:account name  optional description after two spaces
              o 2015/03/30 09:20:00
              i 2015/03/31 22:21:45 another account
              o 2015/04/01 02:00:34

       hledger  treats each clock-in/clock-out pair as a transaction posting some number of hours to an account.
       Or if the session spans more than one day, it is split into several transactions, one for each day.   For
       the above time log, hledger print generates these journal entries:

              $ hledger -f t.timeclock print
              2015-03-30 * optional description after two spaces
                  (some:account name)         0.33h

              2015-03-31 * 22:21-23:59
                  (another account)         1.64h

              2015-04-01 * 00:00-02:00
                  (another account)         2.01h

       Here is a sample.timeclock to download and some queries to try:

              $ hledger -f sample.timeclock balance                               # current time balances
              $ hledger -f sample.timeclock register -p 2009/3                    # sessions in march 2009
              $ hledger -f sample.timeclock register -p weekly --depth 1 --empty  # time summary by week

       To generate time logs, ie to clock in and clock out, you could:

       • use  emacs  and  the  built-in  timeclock.el,  or the extended timeclock-x.el and perhaps the extras in
         ledgerutils.el

       • at the command line, use these bash aliases: shell     alias ti="echo i `date '+%Y-%m-%d %H:%M:%S'` \$*
         >>$TIMELOG"     alias to="echo o `date '+%Y-%m-%d %H:%M:%S'` >>$TIMELOG"

       • or use the old ti and to scripts in the ledger 2.x repository.  These rely on a "timeclock"  executable
         which I think is just the ledger 2 executable renamed.

REPORTING BUGS

       Report bugs at http://bugs.hledger.org (or on the #hledger IRC channel or hledger mail list)

AUTHORS

       Simon Michael <simon@joyful.com> and contributors

COPYRIGHT

       Copyright (C) 2007-2019 Simon Michael.
       Released under GNU GPL v3 or later.

SEE ALSO

       hledger(1),    hledger-ui(1),   hledger-web(1),   hledger-api(1),   hledger_csv(5),   hledger_journal(5),
       hledger_timeclock(5), hledger_timedot(5), ledger(1)

       http://hledger.org

hledger 1.18.99                                  September 2020                             hledger_timeclock(5)