PHP日期函数怎么用-php教程-PHP中文网

php日期函数怎么用

date() 和 date_format() 用哪个？

直接说结论：新项目优先用 date_format()（配合 DateTime 对象），老代码维护或简单格式化用 date()。前者更面向对象、时区处理干净，后者依赖全局时区设置，容易在多时区场景出错。

常见错误现象：date('Y-m-d H:i:s') 在服务器时区是 UTC 但业务要 Asia/Shanghai，结果时间慢 8 小时；或者调用 date_default_timezone_set('PRC') 后影响其他模块。

date() 只能格式化时间戳，必须先用 strtotime() 或 time() 转换，无法直接处理带时区的字符串
date_format($datetime, 'Y-m-d H:i:s') 的 $datetime 是 DateTime 实例，创建时就能指定时区：new DateTime('2024-06-15 14:30:00', new DateTimeZone('Asia/Shanghai'))
性能上差异极小，但 DateTime 在复杂操作（如加减多个间隔、比较跨时区时间）时逻辑更清晰，不易漏掉 setTimezone()

strtotime() 解析日期字符串为什么经常不准？

根本原因：它依赖模糊的启发式规则，对非标准格式容忍度高，但结果不可控。比如 strtotime('06/15/2024') 在美国服务器解析为 June，欧洲服务器可能当 May（dd/mm/yyyy 优先级干扰）。

使用场景：仅限可信、固定格式的输入（如表单提交的 Y-m-d），且你完全掌控服务器环境。

绝对避免解析用户自由输入的日期，例如 “昨天”、“下周一”、“3天后” —— 这些用 DateTime::modify() 更稳
如果必须用 strtotime()，强制加时区上下文：strtotime('2024-06-15 14:30:00 +0800')，否则默认按本地时区解释
替代方案：用 DateTime::createFromFormat('Y-m-d H:i:s', $input)，明确指定格式，失败时返回 false，可主动报错

date_diff() 返回的对象怎么取天数？别直接读 `$diff->days`

这是最常踩的坑：$diff->days 是总天数（含跨月/年折算），而 $diff->d 才是“日”字段（即两个日期在同月内差几天）。比如 2024-01-30 到 2024-02-02，$diff->days === 3（正确），但 $diff->d === 2（错误，因为 2 月 2 日 - 1 月 30 日 ≠ 2 天）。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

真正需要“相差多少完整自然日”，无条件用 $diff->days；如果要做“X月Y日 + Z天”这种计算，必须用 DateTime::modify('+3 days')，而不是手动加 $d 字段。

$diff = date_diff($date1, $date2) 返回 DateInterval 对象，所有字段（y, m, d, h 等）都是“余数”，不是总值
要获取总秒数、总分钟数，用 $diff->s + $diff->i * 60 + $diff->h * 3600 + $diff->days * 86400 —— 注意，这里必须用 days，不能用 d
跨时区比较前，务必先统一时区：$date1->setTimezone($tz)->format('U') 再 diff，否则 days 会因夏令时等产生 1 天偏差

PHP 8.2+ 的 `date_parse_from_format()` 能信吗？

能信，但只适合做格式校验，不适合提取时间。它返回数组，其中 ['error_count'] > 0 表示解析失败，['warning_count'] > 0 表示有歧义（比如二月30号被转成三月2号，但不报错）。

典型误用：拿 date_parse_from_format('Y-m-d', '2024-02-30')['day'] 当 2，实际是 2（自动归正），但业务上这可能是用户输错了。

正确用法：先用它检查格式合法性，再用 DateTime::createFromFormat() 创建对象，后者在严格模式下（!$dt instanceof DateTime）可捕获归正行为
注意 date_parse_from_format() 不处理时区，返回的 ['zone'] 是原始字符串里的偏移（如 +0800），不是解析后的时区对象
和 strtotime() 一样，它不验证日期有效性（如 2024-02-30 会被接受），所以不能代替业务层校验

时区、格式字符串的字母大小写、以及“总天数 vs 日字段”的混淆，是 PHP 日期函数里最隐蔽也最容易线上出问题的三处。动手前先想清楚：你要的是“显示用的时间”，还是“计算用的间隔”，两者 API 路径完全不同。