date_create() 不接受时间戳,仅支持日期字符串;传时间戳需转为"@1717027200"或先用date()格式化;必须注意时区,默认UTC,推荐显式指定Asia/Shanghai;返回false常见于不可见字符、两位年份、非标准分隔符;优先使用new DateTime()替代。

date_create() 不能直接传时间戳
很多人以为 date_create() 和 date() 一样能直接处理时间戳,结果传个 1717027200 进去,返回 false 或报错 “A non-well-formed date/time string”。它只接受字符串格式的日期时间,比如 "2024-05-30"、"now"、"+3 days",不接受整数时间戳。
如果手头是时间戳,得先转成字符串再用:
$ts = 1717027200;<br>$dt = date_create(date('Y-m-d H:i:s', $ts)); // 正确<br>// 或更简洁地:<br>$dt = date_create("@$ts"); // @ 符号开头可直接解析为 Unix 时间戳
-
@1717027200是合法输入,但注意:它默认按 UTC 解析,不带时区上下文 - 若原时间戳本就带时区(比如来自 MySQL 的
DATETIME字段),别盲目加@,否则可能偏移 8 小时 - 用
date_create_from_format()更安全——当你明确知道输入格式时
时区没设好,date_create() 返回的时间就不可靠
默认情况下,date_create() 使用 PHP 配置的默认时区(date.timezone),但如果代码运行在共享环境或未显式配置时区的容器里,结果可能和本地开发不一致,尤其涉及 "today"、"tomorrow" 这类相对表达式时。
推荐始终显式指定时区:
$dt = date_create('2024-05-30 14:30', timezone_open('Asia/Shanghai'));
- 不传第二个参数 ≠ 当前服务器时区可靠;很多 Docker 镜像默认是 UTC
- 用
timezone_open('PRC')不推荐——PRC是别名,PHP 8.2+ 已弃用,应改用Asia/Shanghai - 如果只是想让所有
date_create()默认用某个时区,改date.timezone配置比每个调用都传更稳妥
date_create() 返回 false 的常见原因
返回 false 不代表语法错了,往往是隐性解析失败。常见触发点:
立即学习“PHP免费学习笔记(深入)”;
- 字符串含不可见字符(比如从 Excel 复制的日期带 BOM 或全角空格)——用
trim()+mb_detect_encoding()排查 - 年份写成两位(如
"23-05-30"),PHP 可能误判为 1923 年,某些版本甚至直接失败 - 使用了非标准分隔符但没配
date_create_from_format(),比如"2024/05/30"在某些 locale 下会失败 - 中文或其它多字节语言写的“今天”“明天”——
date_create()完全不支持,只认英文关键词
调试建议:先用 var_dump($dt); 看是否为 false,再用 date_get_last_errors() 查具体哪部分出错:
$dt = date_create("2024-05-30T14:30:00+08:00");<br>if ($dt === false) {<br> var_dump(date_get_last_errors());<br>}
比起 date_create(),多数场景该用 DateTime 构造函数
date_create() 是面向过程风格的封装,底层就是 new DateTime()。但构造函数更直观、错误提示更明确,且支持更多选项(比如 DateTimeZone 对象直接传参)。
- 等价写法:
date_create('now')≡new DateTime('now') - 构造函数在 PHP 8+ 对无效输入抛
Exception(可捕获),而date_create()只静默返回false,容易漏错 - 链式调用更自然:
(new DateTime())->modify('+1 day')->format('Y-m-d'),不用反复传变量
除非维护老项目或必须保持函数式风格,否则优先写 new DateTime(...) ——不是语法糖,是更可控的接口。
真正容易被忽略的是:哪怕你用了 date_create(),它的返回值也是 DateTime 实例,后续所有方法(format()、modify()、getTimestamp())都一样,别把它当成“简化版”就少用功能。



















