TITLE
solstice - Calculate equinox and solstice times for a given year.
SYNOPSIS
solstice
solstice 2012
solstice 44bc
solstice -help
solstice -versionOPTIONS
-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 ukThis 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-2024 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.