PHP农历、节日、节气、季节等日历计算

本文为为修改整合过后的方便，记录一下便于使用。

• convertSolarToLunar 将阳历转换为阴历
• convertLunarToSolar 将阴历转换为阳历
• isLeapYear 判断是否是闰年
• getLunarYearName 获取干支纪年
• getYearZodiac 根据阴历年获取生肖
• getSolarMonthDays 获取阳历月份的天数
• getLunarMonthDays 获取阴历月份的天数
• getLeapMonth 获取闰月
• getDaysBetweenLunar 计算阴历日期与正月初一相隔的天数
• getDaysBetweenSolar 计算2个阳历日期之间的天数
• getCapitalNum 获取数字的阴历叫法
• getSolarTerm 获取当前节气
• getSeason 根据节气获取季节
• getFestival 获取节日

（本扩展类不保证完全正确，如有问题请联系本人修改）

<?php
/**
 * @Author: [FENG] <1161634940@qq.com>
 * @Date:   2019-08-07T13:09:47+08:00
 * @Last Modified by:   [FENG] <1161634940@qq.com>
 * @Last Modified time: 2021-05-08 17:07:29
 * Class Lunar
 * 农历 节气 节日
 */
namespace feng;

class Lunar
{

    public $MIN_YEAR = 1891;

    public $MAX_YEAR = 2100;

    public $lunarInfo = array(
        array(0,2,9,21936),array(6,1,30,9656),array(0,2,17,9584),array(0,2,6,21168),array(5,1,26,43344),array(0,2,13,59728),
        array(0,2,2,27296),array(3,1,22,44368),array(0,2,10,43856),array(8,1,30,19304),array(0,2,19,19168),array(0,2,8,42352),
        array(5,1,29,21096),array(0,2,16,53856),array(0,2,4,55632),array(4,1,25,27304),array(0,2,13,22176),array(0,2,2,39632),
        array(2,1,22,19176),array(0,2,10,19168),array(6,1,30,42200),array(0,2,18,42192),array(0,2,6,53840),array(5,1,26,54568),
        array(0,2,14,46400),array(0,2,3,54944),array(2,1,23,38608),array(0,2,11,38320),array(7,2,1,18872),array(0,2,20,18800),
        array(0,2,8,42160),array(5,1,28,45656),array(0,2,16,27216),array(0,2,5,27968),array(4,1,24,44456),array(0,2,13,11104),
        array(0,2,2,38256),array(2,1,23,18808),array(0,2,10,18800),array(6,1,30,25776),array(0,2,17,54432),array(0,2,6,59984),
        array(5,1,26,27976),array(0,2,14,23248),array(0,2,4,11104),array(3,1,24,37744),array(0,2,11,37600),array(7,1,31,51560),
        array(0,2,19,51536),array(0,2,8,54432),array(6,1,27,55888),array(0,2,15,46416),array(0,2,5,22176),array(4,1,25,43736),
        array(0,2,13,9680),array(0,2,2,37584),array(2,1,22,51544),array(0,2,10,43344),array(7,1,29,46248),array(0,2,17,27808),
        array(0,2,6,46416),array(5,1,27,21928),array(0,2,14,19872),array(0,2,3,42416),array(3,1,24,21176),array(0,2,12,21168),
        array(8,1,31,43344),array(0,2,18,59728),array(0,2,8,27296),array(6,1,28,44368),array(0,2,15,43856),array(0,2,5,19296),
        array(4,1,25,42352),array(0,2,13,42352),array(0,2,2,21088),array(3,1,21,59696),array(0,2,9,55632),array(7,1,30,23208),
        array(0,2,17,22176),array(0,2,6,38608),array(5,1,27,19176),array(0,2,15,19152),array(0,2,3,42192),array(4,1,23,53864),
        array(0,2,11,53840),array(8,1,31,54568),array(0,2,18,46400),array(0,2,7,46752),array(6,1,28,38608),array(0,2,16,38320),
        array(0,2,5,18864),array(4,1,25,42168),array(0,2,13,42160),array(10,2,2,45656),array(0,2,20,27216),array(0,2,9,27968),
        array(6,1,29,44448),array(0,2,17,43872),array(0,2,6,38256),array(5,1,27,18808),array(0,2,15,18800),array(0,2,4,25776),
        array(3,1,23,27216),array(0,2,10,59984),array(8,1,31,27432),array(0,2,19,23232),array(0,2,7,43872),array(5,1,28,37736),
        array(0,2,16,37600),array(0,2,5,51552),array(4,1,24,54440),array(0,2,12,54432),array(0,2,1,55888),array(2,1,22,23208),
        array(0,2,9,22176),array(7,1,29,43736),array(0,2,18,9680),array(0,2,7,37584),array(5,1,26,51544),array(0,2,14,43344),
        array(0,2,3,46240),array(4,1,23,46416),array(0,2,10,44368),array(9,1,31,21928),array(0,2,19,19360),array(0,2,8,42416),
        array(6,1,28,21176),array(0,2,16,21168),array(0,2,5,43312),array(4,1,25,29864),array(0,2,12,27296),array(0,2,1,44368),
        array(2,1,22,19880),array(0,2,10,19296),array(6,1,29,42352),array(0,2,17,42208),array(0,2,6,53856),array(5,1,26,59696),
        array(0,2,13,54576),array(0,2,3,23200),array(3,1,23,27472),array(0,2,11,38608),array(11,1,31,19176),array(0,2,19,19152),
        array(0,2,8,42192),array(6,1,28,53848),array(0,2,15,53840),array(0,2,4,54560),array(5,1,24,55968),array(0,2,12,46496),
        array(0,2,1,22224),array(2,1,22,19160),array(0,2,10,18864),array(7,1,30,42168),array(0,2,17,42160),array(0,2,6,43600),
        array(5,1,26,46376),array(0,2,14,27936),array(0,2,2,44448),array(3,1,23,21936),array(0,2,11,37744),array(8,2,1,18808),
        array(0,2,19,18800),array(0,2,8,25776),array(6,1,28,27216),array(0,2,15,59984),array(0,2,4,27424),array(4,1,24,43872),
        array(0,2,12,43744),array(0,2,2,37600),array(3,1,21,51568),array(0,2,9,51552),array(7,1,29,54440),array(0,2,17,54432),
        array(0,2,5,55888),array(5,1,26,23208),array(0,2,14,22176),array(0,2,3,42704),array(4,1,23,21224),array(0,2,11,21200),
        array(8,1,31,43352),array(0,2,19,43344),array(0,2,7,46240),array(6,1,27,46416),array(0,2,15,44368),array(0,2,5,21920),
        array(4,1,24,42448),array(0,2,12,42416),array(0,2,2,21168),array(3,1,22,43320),array(0,2,9,26928),array(7,1,29,29336),
        array(0,2,17,27296),array(0,2,6,44368),array(5,1,26,19880),array(0,2,14,19296),array(0,2,3,42352),array(4,1,24,21104),
        array(0,2,10,53856),array(8,1,30,59696),array(0,2,18,54560),array(0,2,7,55968),array(6,1,27,27472),array(0,2,15,22224),
        array(0,2,5,19168),array(4,1,25,42216),array(0,2,12,42192),array(0,2,1,53584),array(2,1,21,55592),array(0,2,9,54560)
    );

    /**
     * [convertSolarToLunar 将阳历转换为阴历]
     * @param  [type] $year  [公历-年]
     * @param  [type] $month [公历-月]
     * @param  [type] $date  [公历-日]
     * @return [type]        [description]
     */
    public function convertSolarToLunar($today)
    {
        list($year,$month,$day) = explode('-',$today);
        $yearData = $this->lunarInfo[$year-$this->MIN_YEAR];
        if($year==$this->MIN_YEAR&&$month<=2&&$day<=9) return array(1891,'正月','初一','辛卯',1,1,'兔');
        return $this->getLunarByBetween($year,$this->getDaysBetweenSolar($year,$month,$day,$yearData[1],$yearData[2]));
    }

    /**
     * [convertLunarToSolar 将阴历转换为阳历]
     * @param  [type] $year  [阴历-年]
     * @param  [type] $month [阴历-月，闰月处理：例如如果当年闰五月，那么第二个五月就传六月，相当于阴历有13个月，只是有的时候第13个月的天数为0]
     * @param  [type] $date  [阴历-日]
     * @return [type]        [description]
     */
    public function convertLunarToSolar($year,$month,$date)
    {
        $yearData = $this->lunarInfo[$year-$this->MIN_YEAR];
        $between = $this->getDaysBetweenLunar($year,$month,$date);
        $res = mktime(0,0,0,$yearData[1],$yearData[2],$year);
        $res = date('Y-m-d', $res+$between*24*60*60);
        $day = explode('-', $res);
        $year = $day[0];
        $month= $day[1];
        $day = $day[2];
        return array($year, $month, $day);
    }

    /**
     * [isLeapYear 判断是否是闰年]
     * @param  [type]  $year [年份]
     * @return boolean       [description]
     */
    public function isLeapYear($year)
    {
        return (($year%4==0 && $year%100 !=0) || ($year%400==0));
    }

    /**
     * [getLunarYearName 获取干支纪年]
     * @param  [type] $year [年份]
     * @return [type]       [description]
     */
    public function getLunarYearName($year)
    {
        $sky = array('庚','辛','壬','癸','甲','乙','丙','丁','戊','己');
        $earth = array('申','酉','戌','亥','子','丑','寅','卯','辰','巳','午','未');
        $year = $year.'';
        return $sky[$year{3}].$earth[$year%12];
    }

    /**
     * [getYearZodiac 根据阴历年获取生肖]
     * @param  [type] $year [阴历年]
     * @return [type]       [description]
     */
    public function getYearZodiac($year)
    {
        $zodiac = array('猴','鸡','狗','猪','鼠','牛','虎','兔','龙','蛇','马','羊');
        return $zodiac[$year%12];
    }

    /**
     * [getSolarMonthDays 获取阳历月份的天数]
     * @param  [type] $year  [阳历-年]
     * @param  [type] $month [阳历-月]
     * @return [type]        [description]
     */
    public function getSolarMonthDays($year,$month)
    {
        return date('t', strtotime($year.'-'.$month));
    }

    /**
     * [getLunarMonthDays 获取阴历月份的天数]
     * @param  [type] $year  [阴历-年]
     * @param  [type] $month [阴历-月，从一月开始]
     * @return [type]        [description]
     */
    public function getLunarMonthDays($year,$month)
    {
        $monthData = $this->getLunarMonths($year);
        return $monthData[$month-1];
    }

    /**
     * [getLunarMonths 获取阴历每月的天数的数组]
     * @param  [type] $year [年份]
     * @return [type]       [description]
     */
    public function getLunarMonths($year)
    {
        $yearData = $this->lunarInfo[$year - $this->MIN_YEAR];
        $leapMonth = $yearData[0];
        $bit = decbin($yearData[3]);
        for ($i = 0; $i < strlen($bit);$i ++) $bitArray[$i] = substr($bit, $i, 1);
        for($k=0,$klen=16-count($bitArray);$k<$klen;$k++) array_unshift($bitArray, '0');
        $bitArray = array_slice($bitArray,0,($leapMonth==0?12:13));
        for($i=0; $i<count($bitArray); $i++) $bitArray[$i] = $bitArray[$i] + 29;
        return $bitArray;
    }

    /**
     * [getLunarYearDays 获取农历每年的天数]
     * @param  [type] $year [农历年份]
     * @return [type]       [description]
     */
    public function getLunarYearDays($year)
    {
        $yearData = $this->lunarInfo[$year-$this->MIN_YEAR];
        $monthArray = $this->getLunarYearMonths($year);
        $len = count($monthArray);
        return ($monthArray[$len-1]==0?$monthArray[$len-2]:$monthArray[$len-1]);
    }

    public function getLunarYearMonths($year)
    {
        $monthData = $this->getLunarMonths($year);
        $res=array();
        $temp=0;
        $yearData = $this->lunarInfo[$year-$this->MIN_YEAR];
        $len = ($yearData[0]==0?12:13);
        for($i=0;$i<$len;$i++)
        {
            $temp=0;
            for($j=0;$j<=$i;$j++) $temp+=$monthData[$j];
            array_push($res, $temp);
        }
        return $res;
    }

    /**
     * [getLeapMonth 获取闰月]
     * @param  [type] $year [阴历年份]
     * @return [type]       [description]
     */
    public function getLeapMonth($year)
    {
        $yearData = $this->lunarInfo[$year-$this->MIN_YEAR];
        return $yearData[0];
    }

    /**
     * [getDaysBetweenLunar 计算阴历日期与正月初一相隔的天数]
     * @param  [type] $year  [description]
     * @param  [type] $month [description]
     * @param  [type] $date  [description]
     * @return [type]        [description]
     */
    public function getDaysBetweenLunar($year,$month,$date)
    {
        $yearMonth = $this->getLunarMonths($year);
        $res=0;
        for($i=1;$i<$month;$i++) $res +=$yearMonth[$i-1];
        $res+=$date-1;
        return $res;
    }

    /**
     * [getDaysBetweenSolar 计算2个阳历日期之间的天数]
     * @param  [type] $year   [阳历年]
     * @param  [type] $cmonth [阳历月]
     * @param  [type] $cdate  [阳历日]
     * @param  [type] $dmonth [另一个阳历月]
     * @param  [type] $ddate  [另一个阳历日]
     * @return [type]         [description]
     */
    public function getDaysBetweenSolar($year,$cmonth,$cdate,$dmonth,$ddate)
    {
        $a = mktime(0,0,0,$cmonth,$cdate,$year);
        $b = mktime(0,0,0,$dmonth,$ddate,$year);
        return ceil(($a-$b)/24/3600);
    }

    /**
     * [getLunarByBetween 根据距离正月初一的天数计算阴历日期]
     * @param  [type] $year    [阳历年]
     * @param  [type] $between [天数]
     * @return [type]          [description]
     */
    public function getLunarByBetween($year,$between)
    {
        $lunarArray = array();
        $yearMonth = array();
        $t=0;
        $e=0;
        $leapMonth=0;
        $m='';
        if($between==0) {
            array_push($lunarArray, $year,'正月','初一');
            $t = 1;
            $e = 1;
        } else {
            $year = $between>0? $year : ($year-1);
            $yearMonth = $this->getLunarYearMonths($year);
            $leapMonth = $this->getLeapMonth($year);
            $between = $between>0?$between : ($this->getLunarYearDays($year)+$between);
            for ($i=0;$i<13;$i++) {
                if($between==$yearMonth[$i]) {
                    $t=$i+2;
                    $e=1;
                    break;
                } else if ($between<$yearMonth[$i]) {
                    $t=$i+1;
                    $e=$between-(empty($yearMonth[$i-1])?0:$yearMonth[$i-1])+1;
                    break;
                }
            }
            $m = ($leapMonth!=0&&$t==$leapMonth+1)?('闰'.$this->getCapitalNum($t- 1,true)):$this->getCapitalNum(($leapMonth!=0&&$leapMonth+1<$t?($t-1):$t),true);
            array_push($lunarArray,$year,$m,$this->getCapitalNum($e,false));
        }
        array_push($lunarArray,$this->getLunarYearName($year));// 天干地支
        array_push($lunarArray,$t,$e);
        array_push($lunarArray,$this->getYearZodiac($year));// 12生肖
        array_push($lunarArray,$leapMonth);// 闰几月
        return $lunarArray;
    }

    /**
     * [getCapitalNum 获取数字的阴历叫法]
     * @param  [type] $num     [数字]
     * @param  [type] $isMonth [是否是月份的数字]
     * @return [type]          [description]
     */
    public function getCapitalNum($num,$isMonth)
    {
        $isMonth = $isMonth || false;
        $dateHash=array('0'=>'','1'=>'一','2'=>'二','3'=>'三','4'=>'四','5'=>'五','6'=>'六','7'=>'七','8'=>'八','9'=>'九','10'=>'十 ');
        $monthHash=array('0'=>'','1'=>'正月','2'=>'二月','3'=>'三月','4'=>'四月','5'=>'五月','6'=>'六月','7'=>'七月','8'=>'八月','9'=>'九月','10'=>'十月','11'=>'冬月','12'=>'腊月');
        $res='';
        if($isMonth) $res = $monthHash[$num];
        else
        {
            if($num<=10) $res = '初'.$dateHash[$num];
            else if($num>10&&$num<20) $res = '十'.$dateHash[$num-10];
            else if($num==20) $res = "二十";
            else if($num>20&&$num<30) $res = "廿".$dateHash[$num-20];
            else if($num==30) $res = "三十";
        }
        return $res;
    }

    /**
     * [getSolarTerm 节气通用算法]
     * @param  [type] $today [公历-(年-月-日)]
     * @return [type]        [description]
     */
    public function getSolarTerm($today)
    {
        list($_year,$month,$day) = explode('-',$today);
        $year = substr($_year,-2)+0;
        $coefficient = array(
            array(5.4055,2019,-1),//小寒
            array(20.12,2082,1),//大寒
            array(3.87),//立春
            array(18.74,2026,-1),//雨水
            array(5.63),//惊蛰
            array(20.646,2084,1),//春分
            array(4.81),//清明
            array(20.1),//谷雨
            array(5.52,1911,1),//立夏
            array(21.04,2008,1),//小满
            array(5.678,1902,1),//芒种
            array(21.37,1928,1),//夏至
            array(7.108,2016,1),//小暑
            array(22.83,1922,1),//大暑
            array(7.5,2002,1),//立秋
            array(23.13),//处暑
            array(7.646,1927,1),//白露
            array(23.042,1942,1),//秋分
            array(8.318),//寒露
            array(23.438,2089,1),//霜降
            array(7.438,2089,1),//立冬
            array(22.36,1978,1),//小雪
            array(7.18,1954,1),//大雪
            array(21.94,2021,-1)//冬至
        );
        $term_name = array(
            "小寒","大寒","立春","雨水","惊蛰","春分","清明","谷雨",
            "立夏","小满","芒种","夏至","小暑","大暑","立秋","处暑",
            "白露","秋分","寒露","霜降","立冬","小雪","大雪","冬至");

        $idx1 = ($month-1)*2;
        $_leap_value = floor(($year-1)/4);

        $day1 = floor($year*0.2422+$coefficient[$idx1][0])-$_leap_value;
        if(isset($coefficient[$idx1][1])&&$coefficient[$idx1][1]==$_year) $day1 += $coefficient[$idx1][2];
        $day2 = floor($year*0.2422+$coefficient[$idx1+1][0])-$_leap_value;
        if(isset($coefficient[$idx1+1][1])&&$coefficient[$idx1+1][1]==$_year) $day1 += $coefficient[$idx1+1][2];

        $data=array();
        if($day<$day1){
            $data['name1']=$term_name[$idx1-1];
            $data['name2']=$term_name[$idx1-1].'后';
        }else if($day==$day1){
            $data['name1']=$term_name[$idx1];
            $data['name2']=$term_name[$idx1];
        }else if($day>$day1 && $day<$day2){
            $data['name1']=$term_name[$idx1];
            $data['name2']=$term_name[$idx1].'后';
        }else if($day==$day2){
            $data['name1']=$term_name[$idx1+1];
            $data['name2']=$term_name[$idx1+1];
        }else if($day>$day2){
            $data['name1']=$term_name[$idx1+1];
            $data['name2']=$term_name[$idx1+1].'后';
        }

        return $data;
    }

    /**
     * [getSeason 根据节气获取季节]
     * @param  string $value [公历-(年-月-日)]
     * @return [type]        [description]
     */
    public function getSeason($today)
    {
        $term = $this->getSolarTerm($today);
        $term_name = array(
            "立春","雨水","惊蛰","春分","清明","谷雨", // 春
            "立夏","小满","芒种","夏至","小暑","大暑", // 夏
            "立秋","处暑","白露","秋分","寒露","霜降", // 秋
            "立冬","小雪","大雪","冬至","小寒","大寒"  // 冬
        );
        $season_name = array('春', '夏', '秋', '冬');
        $num = ceil(array_search($term['name1'], $term_name)/6);
        return $season_name[$num] ?? '';
    }

    /**
     * [getFestival 获取节日：特殊的节日只能修改此函数来计算]
     * @param  [type]  $today   [公历-(年-月-日)]
     * @param  boolean $nl_info [description]
     * @param  integer $config  [description]
     * @return [type]           [description]
     */
    public function getFestival($today, $nl_info = false,$config = 1)
    {
        if($config == 1)
        {
            $arr_lunar=array('01-01'=>'春节','01-15'=>'元宵节','02-02'=>'二月二','05-05'=>'端午节','07-07'=>'七夕节','08-15'=>'中秋节','09-09'=>'重阳节','12-08'=>'腊八节','12-23'=>'小年');
            $arr_solar=array('01-01'=>'元旦','02-14'=>'情人节','03-12'=>'植树节','04-01'=>'愚人节','05-01'=>'劳动节','06-01'=>'儿童节','10-01'=>'国庆节','10-31'=>'万圣节','12-24'=>'平安夜','12-25'=>'圣诞节');
        } //需要不同节日的，用不同的$config,然后配置$arr_lunar和$arr_solar

        $festivals = array();

        if(!$nl_info) $nl_info = $this->convertSolarToLunar($today);

        if($nl_info[7]>0&&$nl_info[7]<$nl_info[4]) $nl_info[4]-=1;
        $md_lunar = substr('0'.$nl_info[4],-2).'-'.substr('0'.$nl_info[5],-2);
        $md_solar=substr_replace($today,'',0,5);

        isset($arr_lunar[$md_lunar])?array_push($festivals, $arr_lunar[$md_lunar]):'';
        isset($arr_solar[$md_solar])?array_push($festivals, $arr_solar[$md_solar]):'';

        $glweek  = date("w",strtotime($today));    //0-6

        if($m==5&&($d>7)&&($d<15)&&($glweek==0))array_push($festivals, "母亲节");
        if($m==6&&($d>14)&&($d<22)&&($glweek==0))array_push($festivals,"父亲节");

        $term = $this->getSolarTerm($today);
        if($term)array_push($festivals,$term);
        return implode('/',$festivals);
    }
}