Chinese calendar
Installing
$ composer require overtrue/chinese-calendar -vvv
Usage
use Overtrue\ChineseCalendar\Calendar;
date_default_timezone_set('PRC');
$calendar = new Calendar();
$result = $calendar->solar(2017, 5, 5); // 阳历
$result = $calendar->lunar(2017, 4, 10); // 阴历
$result = $calendar->solar(2017, 5, 5, 23) // 阳历,带 $hour 参数
结果:
array(
'lunar_year': '2017', // 农历年
'lunar_month': '04', // 农历月
'lunar_day': '10', // 农历日
'lunar_hour': NULL, // 农历时
'lunar_year_chinese': '二零一七', // (汉字)农历年
'lunar_month_chinese': '四月', // (汉字)农历月
'lunar_day_chinese': '初十', // (汉字)农历日
'lunar_hour_chinese': NULL, // (汉字)农历时辰
'ganzhi_year': '丁酉', // (干支)年柱
'ganzhi_month': '乙巳', // (干支)月柱
'ganzhi_day': '壬辰', // (干支)日柱
'ganzhi_hour': NULL, // (干支)时柱
'animal': '鸡', // 生肖
'term': '立夏', // 节气
'is_leap': false, // 是否为闰月
'gregorian_year': '2017', // 公历年
'gregorian_month': '05', // 公历月
'gregorian_day': '05', // 公历日
'gregorian_hour': NULL, // 公历时
'week_no': 5, // (数字)星期几
'week_name': '星期五', // (汉字)星期几
'is_today': false, // 是否为今天
'constellation': '金牛' // 星座
);
array (
'lunar_year' => '2017',
'lunar_month' => '04',
'lunar_day' => '11',
'lunar_hour' => '23', // 农历时
'lunar_year_chinese' => '二零一七',
'lunar_month_chinese' => '四月',
'lunar_day_chinese' => '十一',
'lunar_hour_chinese' => '子时', // (汉字)农历时辰
'ganzhi_year' => '丁酉',
'ganzhi_month' => '乙巳',
'ganzhi_day' => '癸巳',
'ganzhi_hour' => '壬子', // (干支)日柱
'animal' => '鸡',
'term' => NULL,
'is_leap' => false,
'gregorian_year' => '2017',
'gregorian_month' => '05',
'gregorian_day' => '05',
'gregorian_hour' => '23', // 公历时
'week_no' => 5,
'week_name' => '星期五',
'is_today' => false,
'constellation' => '金牛',
);
你可能注意到,含时间的农历结果怎么是
四月十一
而不是四月初十
,具体见 #13
更多 API 请查看源码。
Reference
- 1900年至2100年公历、农历互转Js代码 - 晶晶的博客 - 数据与部分算法来源
- 中国历法 - 维基百科
- 农历 - 维基百科
- 阴历 - 维基百科
- 阳历 - 维基百科
- 干支 - 维基百科
- 星座 - 维基百科
- 生肖 - 维基百科
PHP 扩展包开发
想知道如何从零开始构建 PHP 扩展包?
请关注我的实战课程,我会在此课程中分享一些扩展开发经验 —— 《PHP 扩展包实战教程 - 从入门到发布》
License
MIT