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 failiure.

DESCRIPTION

zodiac_date_name

 $name = zodiac_date_name($dt);
 

Latin zodiac name: aries, taurus, gemini, ... 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 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.

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 ;-)

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. I will be notified, and then you'll automatically be notified of progress on your bug 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) 2006,2007 Maroš. Kollár. All rights reserved.

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.

cpanm DateTime::Event::Zodiac

perl -MCPAN -e shell
install DateTime::Event::Zodiac