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

TITLE

solstice - Calculate equinox and solstice times for a given year.

SYNOPSIS

 solstice
 solstice 2012
 solstice 44bc
 solstice -help
 solstice -version

OPTIONS

-help

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

-local

If asserted, local times are used. Otherwise UTC is used.

-northern

If asserted, this option specifies that the calculation is for the northern hemisphere. If negated, it is for the southern hemisphere, and equinoxes and solstices are exchanged.

The default is -northern (or, equivalently, -nosouthern), but it can be explicitly negated with -nonorthern (or, equivalently, -southern.

If both -northern and -southern are specified, either asserted or negated, the rightmost specification rules.

-reform-date

 -reform-date uk

This option specifies the date the calendar was reformed from Julian to Gregorian. The specification must be acceptable to DateTime::Calendar::Christian, which must be loadable.

-southern

If asserted, this option specifies that the calculation is for the southern hemisphere. The effect is to exchange spring and fall equinoxes and summer and winter solstices.

The default is -nosouthern (or, equivalently, -northern).

If both -northern and -southern are specified, either asserted or negated, the rightmost specification rules.

-version

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

DETAILS

This Perl script calculates the GMT dates and times of the equinoxes and solstices for a given year. The year is specified as the only argument. If this is omitted, you get the data for the current year.

The year is specified either as a signed number (years since 1 BC) or with a trailing era ('AD', 'BC', 'BCE', or 'CE', case-insensitive).

If the DateTime::Calendar::Christian module can be loaded, dates before October 15 1582 will be interpreted and displayed in the Julian calendar. Otherwise all dates are Gregorian, and dates less than 1000AD are not supported.

AUTHOR

Tom Wyant (wyant at cpan dot org)

COPYRIGHT AND LICENSE

Copyright (C) 2016-2017 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.