NAME

Zodiac::Chinese::Table - Look up Chinese zodiac for a given Gregorian date

VERSION

This document describes version 0.021 of Zodiac::Chinese::Table (from Perl distribution Zodiac-Chinese-Table), released on 2020-01-03.

SYNOPSIS

            

              
              
use Chinese::Zodiac::Table qw(chinese_zodiac);
my $res = chinese_zodiac("1980-02-17");
            
          

Sample result:

            

              
              
[
  "1980-02-16",
  "1981-02-04",
  "yang",
  "metal",
  "庚",
  "申",
  "猴",
  "monkey",
]
            
          

DESCRIPTION

This module can look up Chinese zodiac for a given Gregorian date. Compared to Zodiac::Chinese, it uses a lookup table (currently available for Jan 1900 - Feb 2092) so it is more accurate.

Data source is currently at: https://github.com/perlancar/gudangdata (table/chinese_zodiac), which in turn is parsed from Wikipedia article.

FUNCTIONS

chinese_zodiac($date) => arrayref

Return Chinese zodiac information for a Gregorian date $date. Currently date must be a string in the format of YYYY-MM-DD. Will return an arrayref containing these elements:

            

              
              
# index: 0         1           2           3              4               5               6            7
["start_date", "end_date", "yin_yang", "element", "heavenly_stem", "earthly_branch", "zh_animal", "en_animal"].
            
          

Will return undef if date range is unsupported.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Zodiac-Chinese-Table.

SOURCE

Source repository is at https://github.com/perlancar/perl-Zodiac-Chinese-Table.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Zodiac-Chinese-Table

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

Zodiac::Chinese

App::ZodiacUtils distribution contains some CLIs.

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2020, 2015 by perlancar@cpan.org.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm Zodiac::Chinese::Table

perl -MCPAN -e shell
install Zodiac::Chinese::Table