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