/ 
App-JobLog-1.005
River stage zero No dependents
/ App::JobLog::Command::today

NAME

App::JobLog::Command::today - show what has happened today

VERSION

version 1.005

SYNOPSIS

houghton@NorthernSpy:~$ job today --help
job <command>

job today [-f] [long options...]
	-f --finished     show when you can stop working given hours already
	                  work; optional argument indicates span to calculate
	                  hours over or start time; e.g., --finished
	                  yesterday or --finished payperiod
	--help            this usage screen
houghton@NorthernSpy:~$ job t
Monday,  7 March, 2011
  8:01 am - ongoing  1.33  bar, foo  something to add; and still more                                                                                                  

  TOTAL HOURS 1.33
  bar         1.33
  foo         1.33
houghton@NorthernSpy:~$ job t --finished payperiod
Monday,  7 March, 2011
  8:01 am - ongoing  1.34  bar, foo  something to add; and still more                                                                                                  

  TOTAL HOURS 1.34
  bar         1.34
  foo         1.34

you will be finished at  7:17:32 pm on monday, march 07, 2011

DESCRIPTION

App::JobLog::Command::today serves two functions:

  1. Reviewing the current day's events. In this it is completely equivalent to App::JobLog::Command::summary given an option like today, now, or whatever might be the current date.

  2. Determining when you will be able to punch out for the day.

The latter feature requires the --finished option, which takes as its value the starting date for the period over which working time is to be calculated. App::JobLog then iterates over all of the days in the interval so delimited, tallying up all the work hours for the work days (see the workday parameter of App::JobLog::Command::configure) and subtracting vacation time and time worked. If you wish to use the pay period as your interval, you need to have defined the start pay period parameter of App::JobLog::Command::configure.

ACKNOWLEDGEMENTS

This command was inspired by my wife Paula, who frequently wanted to know when I'd be done for the day. In an earlier incarnation of this application one obtained it by passing in the option -p and I knew it as the Paula feature.

SEE ALSO

App::JobLog::Command::summary, App::JobLog::Command::last, App::JobLog::Command::configure, App::JobLog::Command::vacation

AUTHOR

David F. Houghton <dfhoughton@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by David F. Houghton.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.