php判断日期是否为法定节假日,核心在于获取权威数据源并比对目标日期。由于中国法定节假日每年由国务院发布且包含调休安排,无法通过固定公式计算,必须依赖外部日历数据。具体做法是引入一个包含当年所有法定假日和调休上班日的json或数组配置,使用date('y-m-d')格式化输入时间后在配置中进行查找匹配。

如何构建基础节假日数据源
首先需要明确数据源的结构,通常采用键值对形式,键为Y-m-d格式的字符串,值为布尔类型或状态码。例如,"2024-10-01": true表示该日为法定假日,"2024-09-29": false表示该日虽周末但需上班。这种结构便于快速检索,避免了复杂的逻辑判断。

{
"2024-10-01": {"type": "holiday", "name": "国庆节"},
"2024-10-02": {"type": "holiday", "name": "国庆节"},
"2024-09-29": {"type": "workday", "name": "调休"},
"2024-10-12": {"type": "workday", "name": "调休"}
}
上述JSON片段展示了数据的基本形态。在实际项目中,可以将此数据硬编码在配置文件中,或通过API从第三方服务获取。关键在于确保数据的准确性和时效性,因为每年的放假安排可能不同。
立即学习“PHP免费学习笔记(深入)”;
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
如何实现具体的日期比对逻辑
有了数据源后,下一步是实现比对逻辑。创建一个函数isLegalHoliday($date, $config),接收日期字符串和配置数组作为参数。函数内部首先验证日期格式,然后直接在配置数组中查找该日期是否存在。如果存在,返回对应的类型;如果不存在,则默认为普通工作日或周末,根据业务需求进一步处理。

<?php
function isLegalHoliday($date, $config) {
if (!isset($config[$date])) {
return ['is_holiday' => false, 'reason' => 'normal'];
}
$info = $config[$date];
return [
'is_holiday' => $info['type'] === 'holiday',
'reason' => $info['name']
];
}
$config = json_decode(file_get_contents('holidays.json'), true);
$result = isLegalHoliday('2024-10-01', $config);
print_r($result);
?>
运行上述代码,对于2024-10-01,输出将显示is_holiday为true,reason为国庆节。对于非假日日期,如2024-10-05,若配置中无记录,则返回normal。这种实现方式简洁高效,易于维护和扩展。
如何处理调休上班日的特殊情况
调休上班日是法定节假日判断中的难点,因为它们通常是周末但被标记为工作日。在上述配置结构中,通过设置type为workday来区分。在比对逻辑中,需要特别检查type字段,而不仅仅是看日期是否在常见的假日列表中。例如,2024-09-29是周日,但因调休需上班,配置中应明确标注。
<?php
// 假设配置中包含调休信息
$config = [
'2024-09-29' => ['type' => 'workday', 'name' => '调休'],
'2024-10-12' => ['type' => 'workday', 'name' => '调休']
];
$date = '2024-09-29';
if (isset($config[$date]) && $config[$date]['type'] === 'workday') {
echo "$date 是调休上班日\n";
} else {
echo "$date 不是调休上班日\n";
}
?>
这段代码专门处理调休情况。当查询2024-09-29时,程序会正确识别其为调休上班日,从而避免将其误判为休息日。这种细粒度的控制确保了节假日判断的准确性,适用于考勤、排班等对日期敏感的业务场景。


















