/ 
App-JobLog-1.042
River stage zero No dependents
/ App::JobLog::Command::when

NAME

App::JobLog::Command::when - when you'll be done for the day

VERSION

version 1.042

SYNOPSIS

 houghton@NorthernSpy:~job when --help
 job <command> 

 job when [-MmTtV] [long options...] <date or date range>
 	Use 'job help when' to see full details.
	                    
 	-t --tag              filter events to include only those with given
	                      tags; multiple tags may be specified
	-T --exclude-tag      filter events to exclude those with given tags;
	                      multiple tags may be specified
	-m --match            filter events to include only those one of
	                      whose descriptions matches the given regex;
	                      multiple regexes may be specified
	-M --no-match         filter events to include only those one of
	                      whose descriptions do not match the given
	                      regex; multiple regexes may be specified
	-V --no-vacation      do not display vacation hours
	--help                this usage screen
 houghton@NorthernSpy:~$ job w payperiod
 
 you will be finished at  7:17:32 pm

DESCRIPTION

App::JobLog::Command::when says when you will be able to punch out for the day. It does this by iterating over the days in some range of dates, adding up the time worked and subtracted the work hours expected. If no argument is given, the range only includes the current day. (See the workday parameter of App::JobLog::Command::configure.) 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.

Various options are provided to facilitate eliminating certain tasks from the calculation. This is useful if you have more than one employer and you are committed to working a certain number of hours a day for each.

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::tags, 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.