Date::Korean - Conversion between Korean solar / lunisolar date.
use Date::Korean; # convert solar to lunisolar date my ($ly, $lm, $ld, $leap) = sol2lun(2008, 10, 10); # convert lunisolar to solar date my ($sy, $sm, $sd) = lun2sol(2008, 9, 12, 0); # get ganzi in chinese my ($saecha, $wolgun, $iljin) = get_ganzi(2008, 9, 12, 0); # get ganzi in korean my ($saecha, $wolgun, $iljin) = get_ganzi_ko(2008, 9, 12, 0);
The traditional korean lunisolar calendar is based on the chinese calendar. This module handles conversion between Korean solar and lunisolar date.
my ($ly, $lm, $ld, $leap) = sol2lun(2008, 10, 10);
Convert solar to lunisolar date. This function takes solar year, month, day arguements and returns lunisolar year, month, day and leap flag( 1 if month is leap month, or 0 if not )
my ($sy, $sm, $sd) = lun2sol(2008, 9, 12, 0);
Convert lunisolar to solar date. This function takes lunisolar year, month, day, leap flag and returns solar year, month, day.
my ($saecha, $wolgun, $iljin) = get_ganzi(2008, 9, 12, 0); binmode STDOUT, ':encoding(UTF-8)'; print "$saecha $wolgun $iljin\n";
output
戊子 壬戌 癸未
Get ganzi (sexagenary cycle - 干支) of year(歲次), month(月建), day(日辰) in chinese. This function takes lunisolar year, month, day, leap flag.
my ($saecha, $wolgun, $iljin) = get_ganzi_ko(2008, 9, 12, 0); binmode STDOUT, ':encoding(UTF-8)'; print "$saecha $wolgun $iljin\n";
무자 임술 계미
Get ganzi (sexagenary cycle - 간지) of year(세차), month(월건), day(일진) in korean. This function takes lunisolar year, month, day, leap flag.
Conversion between solar and lunisolar date is very difficult because it based on complicated astronomical calculation. Parameters of the conversion equation are sometimes not constant and should be obtained from astronomical observation. So I used precalculated conversion table because the calculation result does not fully gurantee the accuracy of it.
Conversion table was striped and generated from solar <-> lunisolar conversion service on Korea Astronomy & Space Science Institute ( http://www.kao.re.kr/ ). Currently supported date range is from solar 1391-02-05 ( lunisolar 1391-01-01 ) to 2050-12-31 ( lunisolar 2050-11-18 ).
C.H. Kang <chahkang_AT_gmail.com>
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
DateTime, DateTime::Calendar::Julian, Date::ISO8601
To install Date::Korean, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Date::Korean
CPAN shell
perl -MCPAN -e shell install Date::Korean
For more information on module installation, please visit the detailed CPAN module installation guide.