在php 8.6中,可通过intl扩展创建使用chinese历法的intlcalendar,把指定时区的公历日期转换为农历月、日和闰月标记。关键是传入毫秒时间戳并核对实际历法类型;公历年份不能直接当作该历法的year字段。

官方文档:Description
准备intl和明确的业务日期
确认php --ri intl能显示ICU版本。下面以北京时间当天中午作为日期锚点,避免午夜附近的时区换日;它只转换这个指定日期,不推算节假日安排。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

官方文档:Description
把同一个时间点交给农历日历
<?php
$dt = new DateTimeImmutable('2026-11-23 12:00:00', new DateTimeZone('Asia/Shanghai'));
$cal = IntlCalendar::createInstance('Asia/Shanghai', 'zh_CN@calendar=chinese');
if ($cal === null || $cal->getType() !== 'chinese') {
throw new RuntimeException('Chinese calendar unavailable');
}
if (!$cal->setTime($dt->getTimestamp() * 1000.0)) {
throw new RuntimeException('Cannot set calendar time');
}
$month = $cal->get(IntlCalendar::FIELD_MONTH);
$day = $cal->get(IntlCalendar::FIELD_DAY_OF_MONTH);
$leap = $cal->get(IntlCalendar::FIELD_IS_LEAP_MONTH);
if ($month === false || $day === false || $leap === false) {
throw new RuntimeException('Cannot read calendar fields');
}
printf('%s%d月%d日\n', $leap ? '闰' : '', $month + 1, $day);保存原日期,分别核对年月含义
MONTH字段从0计数,显示时加1;闰月由单独字段判断,不通过月份重复猜测。若还要输出农历年份,必须另外处理ICU的纪年和循环年份,不能直接给YEAR拼上“年”。数据库保留原公历日期、时区和ICU版本,回归样例覆盖春节前后、闰月及不同时区。


















