:date: 中国农历(阴历)与阳历(公历)转换与查询工具
:date: 中国农历(阴历)与阳历(公历)转换与查询工具。
Asia/Shanghai)进行,与进程默认时区(date_default_timezone_set())无关;ext-mbstring 外零依赖;| 版本 | PHP 要求 | 分支 | 说明 |
|---|---|---|---|
| 2.x | >= 8.5 | master |
当前开发版本 |
| 1.x | >= 5.5.9 | 1.x |
仅接受缺陷修复 |
composer require overtrue/chinese-calendaruse Overtrue\ChineseCalendar\Calendar;
$calendar = new Calendar();
$result = $calendar->solar(2017, 5, 5); // 公历 -> 农历
$result = $calendar->lunar(2017, 4, 10); // 农历 -> 公历
$result = $calendar->solar(2017, 5, 5, 23); // 带小时参数(23 点按晚子时归入次日)返回结果:
…| 方法 | 说明 |
|---|---|
solar($year, $month, $day, $hour = null) |
公历转农历,返回完整信息数组 |
lunar($year, $month, $day, $isLeapMonth = false, $hour = null) |
农历转公历,返回完整信息数组 |
solar2lunar($year, $month, $day, $hour = null) |
公历转农历(仅农历信息) |
lunar2solar($year, $month, $day, $isLeapMonth = false) |
农历转公历(仅公历年月日) |
leapMonth($year) / leapDays($year) |
某农历年闰几月 / 闰月天数 |
lunarDays($year, $month) / daysOfYear($year) / monthsOfYear($year) |
农历月天数 / 年总天数 / 年总月数 |
solarDays($year, $month) |
公历某月天数 |
getTerm($year, $no) |
某年第 n 个节气(1 = 小寒)的公历日 |
diffInDays($lunar1, $lunar2, $absolute = true) |
两个农历日期相差的天数(同类还有 diffInMonths / diffInYears) |
addDays / subDays / addMonths / subMonths / addYears / subYears |
农历日期加减 |
更多 API 请查看源码。
$hour = 23 时按「晚子时」归入次日(如 四月初十 23 点会得到 四月十一),日柱、时柱随之计算,见 #13;ganzhi_year 与 animal 以农历正月初一为分界,与 lunar_year 一致;命理学中以立春为界的口径请自行换算;InvalidArgumentException / TypeError,不会静默返回错误结果;2057-09-28。composer test # PHPUnit(含香港天文台全量对照 fixture)
composer check-style # laravel/pint --test
composer phpstan # 静态分析2.0 的计算结果与 1.1.0 完全一致,但有以下不兼容变更:
strict_types 并为所有方法补全了参数与返回类型;ganZhiYear() 与 getAnimal() 移除了已废弃的第二个参数 $termIndex;diffInDays() 返回 int(原为数字字符串);getTerm() 返回 int(原为数字字符串);TypeError / InvalidArgumentException,不再静默产生错误结果。MIT
暂无开放 Issues,或尚未同步最近议题。