The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
DateTime-Event-Zodiac-1.03
River stage one • 1 direct dependent • 2 total dependents
++
/ DateTime::Event::Zodiac

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 exact longitude 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 of the sun.

zodiac_astro_symbol

 $symbol = zodiac_astro_symbol($dt);

Unicode zodiac symbol positions U+2648 to U+2653.

Calculated from the longitude of the sun.

zodiac_date

Simply computes the zodiac from the fixed 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::Astro for notes on accuracy.

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.k-1.com>

COPYRIGHT

DateTime::Event::Zodiac is Copyright (c) 2008-13 Maroš Kollár - http://www.k-1.com

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.