The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

TITLE

almanac - Generate almanac data for a given location

SYNOPSIS

 almanac       # The White House by default
 almanac 52.07 4.29 4   # The Hague
 almanac -help
 almanac -version

OPTIONS

-date=date_string

This option specifies the date as a string that can be parsed by Date::Manip. If Date::Manip can not be loaded an error occurs. If this option is specified, -tomorrow is ignored.

-format=strftime_format

This option specifies the strftime format used to display dates and times. The default is '%d-%b-%Y %H:%M:%S'.

-help

This option displays the documentation for this script. The script then exits.

-moon

Display data for the Moon. Defaults to -nomoon if -sun is asserted.

-sun

Display data for the Sun. Defaults to -nosun if -moon is asserted.

-tomorrow

Display data for tomorrow, rather than today.

-version

This option displays the version of this script. The script then exits.

DETAILS

This Perl script displays today's almanac for the position given on the command line, in latitude north of the Equator, longitude east of the prime meridian, and meters above sea level. If no position is given on the command line, the contents of environment variable ALMANAC_POSITION are broken on spaces and used as the posiiton. If this environment variable is not found, the position of the White House in Washington DC USA is used.

By default, data for both the Sun and Moon are displayed. If you explicitly assert either -sun or -moon, only the selected luminary will be displayed.

You can look a day ahead by specifying -tomorrow.

The format of the time output can be specified using the -format option.

AUTHOR

Thomas R. Wyant, III wyant at cpan dot org

COPYRIGHT AND LICENSE

Copyright (C) 2012-2020 by Thomas R. Wyant, III

This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0. For more details, see the full text of the licenses in the directory LICENSES.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.