NAME
DateTime::Event::Zodiac - Return zodiac for a given date
SYNOPSIS
use DateTime::Event::Zodiac qw(zodiac_date_name zodiac_date_symbol zodiac_astro_name zodiac_astro_symbol);
my $dt = DateTime->new(
year => 1979,
month => 3,
day => 27,
);
print zodiac_date_name($dt);
print zodiac_astro_symbol($dt);Returns the latin zodiac name or alternatively the unicode zodiac symbol for the given date. The zodiac may be calculated using either fixed dates or using the longitude/position of the sun.
The module exports no symbols by default. All used functions must be requested in the use statement.
All methods return undef on failure.
DESCRIPTION
zodiac_date_name
$name = zodiac_date_name($dt);Latin zodiac name: aries, taurus, gemini, cancer, leo, virgo, libra, scorpius, sagittarius, capricornus, aquarius and pisces.
Fixed dates.
zodiac_date_symbol
$symbol = zodiac_date_symbol($dt);Unicode zodiac symbol positions U+2648 to U+2653.
Fixed dates.
zodiac_astro_name
$name = zodiac_astro_name($dt);Latin zodiac name: aries, taurus, gemini, ...
Calculated from the longitude/position of the sun.
zodiac_astro_symbol
$symbol = zodiac_astro_symbol($dt);Unicode zodiac symbol positions U+2648 to U+2653.
Calculated from the longitude/position of the sun.
zodiac_date
Simply computes the zodiac from the date and returns a hash with the keys name, symbol, start and end.
Used internally by zodiac_date_name and zodiac_date_symbol
zodiac_astro
Computes the zodiac from the position of the sun and returns a hash with the keys name, symbol, start and end. The keys start and end should be ignored since they are only used for the zodiac_date function.
May differ from the results of zodiac_date depending on the solar year (leap year ect).
See DateTime::Util::Astro::Sun for notes on accuracy. If computed accurately enough this module should be also able to get the correct zodiac for the exact time of birth. Without having the Math::BigInt::GMP module installed the observed accuracy is about ± 2 hours.
Used internally by zodiac_astro_name and zodiac_astro_symbol
DISCLAIMER
The author of this module regads astrology as being a pseudoscience and superstition. I wrote this module for my job. I was young, foolish and I needed the money.
TODO
The zodiac_astro_horoscope and zodiac_date_horoscope functions have not yet been implemented and probably never will be ;-)
SUPPORT
Please report any bugs or feature requests to datetime-event-zodiac@rt.cpan.org, or through the web interface at http://rt.cpan.org/Public/Bug/Report.html?Queue=DateTime::Event::Zodiac. I will be notified, and then you'll automatically be notified of progress on your report as I make changes.
AUTHOR
Maroš Kollár
CPAN ID: MAROS
maros [at] k-1.com
L<http://www.revdev.at>ACKNOWLEDGEMENTS
This module was written for Revdev http://www.revdev.at, a nice litte software company I run with Koki and Domm (http://search.cpan.org/~domm/).
COPYRIGHT
DateTime::Event::Zodiac is Copyright (c) 2008 Maroš Kollár - http://www.revdev.at
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included with this module.