如何正确解析类似“900”这样的24小时制时间字符串-php教程-PHP中文网

如何正确解析类似“900”这样的24小时制时间字符串

php 的 datetimeimmutable 类无法直接解析如 "900" 这类缺少前导零的 24 小时制时间字符串（如 900 应表示 09:00），需手动补零后才能成功解析。

php 的 datetimeimmutable 类无法直接解析如 "900" 这类缺少前导零的 24 小时制时间字符串（如 900 应表示 09:00），需手动补零后才能成功解析。

在与外部 API 对接时，常会收到以整数形式表示的 24 小时制时间（例如 500 表示 05:00，900 表示 09:00，1400 表示 14:00）。这类格式虽符合业务语义，但不符合 PHP 内置 DateTime 解析器对时间字符串的语法要求。

根据 PHP 官方文档中关于时间格式的说明，标准 24 小时制时间必须为 HHMM 格式，且 HH 部分必须为两位数字（即 00–23），不允许省略前导零。因此：

✅ 1900 → 被识别为 19:00（合法）
❌ 900 → 解析失败：Unexpected character at position 0 (9)，因解析器期望以 09 开头而非 9

正确处理方式：补零标准化

在构造 DateTimeImmutable 实例前，需将整数时间统一格式化为 HHMM 字符串（4 位定长，高位补零）：

$hour = 900;
$formatted = str_pad((string)$hour, 4, '0', STR_PAD_LEFT); // → "0900"
$dt = new \DateTimeImmutable($formatted); // ✅ 成功解析为 09:00:00

或使用条件拼接（更直观）：

$hour = 900;
$hourStr = ($hour <h3>⚠️ 注意事项</h3>

不要依赖 date('H:i', strtotime($hour)) 等间接方式，strtotime() 对 900 的行为不可靠（可能误判为 Unix 时间戳或返回 false）；
若输入可能含非法值（如 2500, 899），建议先校验范围：$hour >= 0 && $hour
在 PHPUnit 测试中，可封装为辅助方法提升可读性：

private function parseHour(int $hour): \DateTimeImmutable
{
    if ($hour  2359 || $hour % 100 >= 60) {
        throw new InvalidArgumentException("Invalid hour format: {$hour}");
    }
    return new \DateTimeImmutable(str_pad((string)$hour, 4, '0', STR_PAD_LEFT));
}