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.

