PHP 5.5日期功能缺失需自定义补全:一、增强日期解析;二、实现儒略日双向转换;三、硬编码本地化名称映射;四、构建支持负年份的BCDateTime类;五、添加ISO周周期运算函数。

如果您在使用 PHP 5.5 环境时发现内置日期处理函数缺失关键能力(如 ISO 8601 周数计算偏差、无本地化星期/月份名称、不支持负年份或儒略日转换等),则需通过自定义函数补充。以下是补全日期功能的具体方法:
一、封装 date() 与 strtotime() 的增强型日期解析函数
PHP 5.5 的 strtotime() 对模糊日期字符串(如“last Monday of March 2024”)支持有限,且 date() 无法直接输出 ISO 周年、ISO 周序号等组合字段。可通过封装底层逻辑实现兼容性扩展。
1、定义函数 date_iso_week,接收时间戳或日期字符串,返回包含 ISO 年、ISO 周、ISO 日的关联数组。
2、内部调用 mktime() 构造基准周一时间,再用 date('W', $ts) 和 date('o', $ts) 提取 ISO 周信息,对跨年边界(如 2024-12-30 属于 2025 年第 1 周)做手动校正。
立即学习“PHP免费学习笔记(深入)”;
3、对输入字符串执行 preg_match 匹配“第X周”“上/下个月”等中文模式,转为 strtotime 可识别格式后二次解析。
二、实现儒略日与格里高利日双向转换函数
PHP 5.5 未提供 juliantojd() / jdtogregorian() 以外的儒略历支持,缺少儒略日序号(JDN)与天文儒略日(JD)的精确换算,也缺乏公元前日期映射能力。需自行实现符合 IAU 标准的转换逻辑。
1、定义函数 gregorian_to_jdn,按公式 JDN = (1461 × (Y + 4800 + (M − 14)/12))/4 + (367 × (M − 2 − 12 × ((M − 14)/12)))/12 − (3 × ((Y + 4900 + (M − 14)/12)/100))/4 + D − 32075 计算儒略日序号。
2、定义函数 jdn_to_gregorian,使用逆向算法还原年、月、日,支持 Y ≤ 0 的负年份表示(即公元前1年记为0,公元前2年记为-1)。
3、在函数入口处校验输入范围:儒略日序号限定在 0 至 5373484 之间,超出则抛出 InvalidArgumentException。
三、注入本地化星期与月份名称映射表
PHP 5.5 的 setlocale() 与 strftime() 在部分系统(如 Windows 或精简版 Linux)中无法正确加载中文 locale,导致 date('l', $ts) 返回英文而非“星期一”。需绕过系统 locale,硬编码多语言映射关系。
1、声明静态数组 $weekdays_zh,键为 0–6(周日–周六),值为 ['星期日','星期一','星期二','星期三','星期四','星期五','星期六']。
2、声明静态数组 $months_zh,键为 1–12,值为 ['一月','二月','三月','四月','五月','六月','七月','八月','九月','十月','十一月','十二月']。
3、定义函数 date_localized,接收格式符(如 'l'、'F')、时间戳和语言代码('zh'/'en'),查表返回对应名称,不依赖系统 locale 设置。
四、构造支持负年份的 DateTime 兼容包装类
PHP 5.5 的 DateTime 类在实例化公元前日期(如 new DateTime('−0001-12-25'))时会静默失败或返回 false,因底层 timelib 不支持 BC 年份解析。需构建独立解析器规避该限制。
1、定义类 BCDateTime,构造函数接受形如 'BC 44-03-15' 或 '-0044-03-15' 的字符串,分离年份符号与数值。
2、对负年份,将年份数值转为绝对值后加 1(即 BC 44 → 45),代入儒略日转换公式计算 JDN,再通过 jdn_to_gregorian 还原为等效格里高利历日期(注意:儒略历与格里高利历在 1582 年前存在 10 日偏差)。
3、提供 format() 方法,支持 'Y' 输出带符号年份(如 −0044),'o' 输出 ISO 年(自动处理跨年周归属)。
五、添加 ISO 8601 周周期运算函数
PHP 5.5 缺少对 ISO 周起始(周一)、ISO 周跨越年份(如 2024-W01 可能含 2023-12-31)的完整支持,date('W') 与 date('o') 单独使用易出错。需实现原子级周周期操作。
1、定义函数 iso_week_start,接收年份与 ISO 周号(如 2024, 1),返回该周周一的 Unix 时间戳。
2、先用 date_create("{$year}-01-04") 定位当年第一个周四(因 ISO 第1周必含该日),再用 date('W') 获取其 ISO 周号,反推第1周周一时间戳,最后偏移 (week_num - 1) × 7 天。
3、定义函数 iso_week_range,返回包含 start_ts 和 end_ts 的数组,其中 end_ts 为周日 23:59:59 时间戳,确保区间闭合且时区无关。











