大网数据广告活动
PHP 语言与运行手册

DateTime::createFromFormat · 根据指定格式解析时间字符串

· 52CE 我爱测

DateTime::createFromFormat -- date_create_from_format — 根据指定格式解析时间字符串

DateTime::createFromFormat

date_create_from_format

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

DateTime::createFromFormat -- date_create_from_format — 根据指定格式解析时间字符串

说明

面向对象风格

public static function DateTime::createFromFormat(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTime|false

过程化风格

function date_create_from_format(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTime|false

返回新的 DateTime 对象,该对象是通过指定 format 将表示日期和时间的 datetime 格式化生成。

类似于 DateTimeImmutable::createFromFormat() 和 date_create_immutable_from_format(),但创建的是 DateTime 对象。

此方法(包括参数、示例和注意事项)记录在 DateTimeImmutable::createFromFormat 页面上。

返回值

返回 DateTime 对象 或者在失败时返回 false。

错误/异常

当 datetime 包含 NULL 字节时,此方法抛出 ValueError。

更新日志

版本 说明
8.0.21、8.1.8、8.2.0 现在,当将 NULL 字节传递到 datetime 时,会引发 ValueError,而之前会默默忽略该错误。

示例

有关大量示例,请参阅 DateTimeImmutable::createFromFormat。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。