PHP DateTime：如何获取某天的首小时与末小时时间点

本文详解在 php 中使用原生 datetime 类或 carbon 库，通过自然语言格式化字符串（如 ‘today 00:00’、’yesterday 23:00’）精准获取任意日期的首小时（00:00:00）和末小时（23:59:59）时间对象，并提供可直接集成到现有日期逻辑中的最佳实践。

本文详解在 php 中使用原生 datetime 类或 carbon 库，通过自然语言格式化字符串（如 ‘today 00:00’、’yesterday 23:00’）精准获取任意日期的首小时（00:00:00）和末小时（23:59:59）时间对象，并提供可直接集成到现有日期逻辑中的最佳实践。

PHP 的 DateTime 构造器支持高度灵活的相对时间表达式，无需手动设置时分秒或调用 setTime() 方法，即可直接解析形如 ‘today 00:00’ 或 ‘yesterday 23:59’ 的字符串。这使得获取“某天的首小时”与“某天的末小时”变得极为简洁——关键在于理解：“首小时”即当天 00:00:00（午夜开始），“末小时”严格来说应为当天 23:59:59（而非 24:00:00，因后者等价于次日 00:00:00）。

✅ 正确用法示例（原生 DateTime）

// 当前日期的首小时（00:00:00）与末小时（23:59:59） $firstHourToday = new DateTime('today 00:00:00'); // 等价于 new DateTime('today') $lastHourToday  = new DateTime('today 23:59:59');  // 昨日的首小时与末小时 $firstHourYesterday = new DateTime('yesterday 00:00:00'); $lastHourYesterday  = new DateTime('yesterday 23:59:59');  // 明日的首/末小时 $firstHourTomorrow = new DateTime('tomorrow 00:00:00'); $lastHourTomorrow  = new DateTime('tomorrow 23:59:59');

⚠️ 注意：’today 23:00′ 仅表示 23:00:00，若需精确到秒级的“末小时”，推荐显式写为 ’23:59:59’；而 ’23:59:59.999999′ 在 DateTime 中不被支持（微秒需用 DateTime::createFromFormat() 配合 u 格式符）。

? 无缝集成到你的现有逻辑中

你当前按 ‘month’ / ‘week’ 分支处理日期范围，现在只需扩展 day 级别逻辑。以下为推荐补全方案（兼容原生 DateTime 与 Carbon）：

if ($this->monthWeekSelect === 'month') {     // 原有月份逻辑保持不变... } elseif ($this->monthWeekSelect === 'week') {     // 原有周逻辑保持不变... } else { // 新增：'day' 模式（或默认 fallback）     // 当日首/末小时     $this->currentDayFirstHour = new DateTime('today 00:00:00');     $this->currentDayLastHour  = new DateTime('today 23:59:59');      // 昨日首/末小时     $this->lastDayFirstHour = new DateTime('yesterday 00:00:00');     $this->lastDayLastHour  = new DateTime('yesterday 23:59:59');      // 明日首/末小时     $this->nextDayFirstHour = new DateTime('tomorrow 00:00:00');     $this->nextDayLastHour  = new DateTime('tomorrow 23:59:59');      // 更多偏移（如 +2 days）同样适用：     $this->plusTwoDaysFirstHour = new DateTime('+2 days 00:00:00');     $this->plusTwoDaysLastHour  = new DateTime('+2 days 23:59:59'); }

✅ 若使用 Carbon（v2+），语法完全一致，且支持链式调用增强可读性：

立即学习“PHP免费学习笔记（深入）”；

use CarbonCarbon;  $lastDayEnd = Carbon::parse('yesterday 23:59:59'); $todayStart = Carbon::today()->startOfDay(); // 等效于 'today 00:00:00' $todayEnd   = Carbon::today()->endOfDay();   // 等效于 'today 23:59:59'

? 关键注意事项

• 时区敏感：所有 ‘today’、’yesterday’ 解析均基于当前默认时区（date_default_timezone_get()）。生产环境务必统一设置时区（如 date_default_timezone_set(‘Asia/Shanghai’)）。
• 避免歧义写法：不要使用 ’24:00’（PHP 会解析为次日 00:00），始终用 ’23:59:59′ 表达当日最后一秒。
• 性能友好：字符串解析由 PHP 内部 C 层完成，效率远高于多次 setTime() 调用。
• 兼容性：该语法自 PHP 5.2.0 起稳定支持，无需额外依赖。

掌握这一技巧后，你不仅能优雅替代冗长的手动时间设置，还能让日期范围逻辑更易维护、更贴近业务语义——毕竟，“昨天的最后一小时”比 $dt->modify(‘-1 day’)->setTime(23,59,59) 更直观、更不易出错。