前端傳遞 02:30:00 pm 格式時間,後端需統一轉為 24 小時制 14:30:00 存儲或比較。
<?php
/**
* 12小時制轉24小時制
* @param string $time12 格式:hh:mm:ss am|pm (不區分大小寫,允許前導零)
* @return string|false 24小時制 H:i:s 或失敗返回 false
*/
function to24Hour(string $time12): string|false {
// 1. 解析並驗證格式
$dt = DateTime::createFromFormat('h:i:s a', $time12);
if ($dt === false) {
// 嘗試無秒格式
$dt = DateTime::createFromFormat('h:i a', $time12);
if ($dt === false) return false;
}
// 2. 格式化輸出
return $dt->format('H:i:s');
}
// 測試
var_dump(to24Hour('02:30:00 pm')); // string(8) "14:30:00"
var_dump(to24Hour('12:00:00 am')); // string(8) "00:00:00"
var_dump(to24Hour('12:00:00 pm')); // string(8) "12:00:00"
var_dump(to24Hour('1:05 am')); // string(8) "01:05:00"
var_dump(to24Hour('invalid')); // bool(false)
<?php
// 陷阱示例
echo date('H:i:s', strtotime('02:30:00 pm')); // 正常:14:30:00
echo date('H:i:s', strtotime('12:00:00 am')); // 正常:00:00:00
echo date('H:i:s', strtotime('12:00:00 pm')); // 正常:12:00:00
// 但 strtotime 對格式寬容度過高,可能誤解析
echo date('H:i:s', strtotime('2:30pm')); // 14:30:00 (可接受)
echo date('H:i:s', strtotime('14:30')); // 14:30:00 (已是24制卻被當作12制解析為02:30:00!)
echo date('H:i:s', strtotime('25:00:00')); // 01:00:00 (下一天,邏輯錯誤)
strtotime 會嘗試解析任何「看起來像時間」的字符串,導致非預期輸入被靜默轉換。DateTime::createFromFormat 嚴格按格式驗證,失敗返回 false,安全得多。
function to24HourLegacy(string $time12): string {
// 手動解析
if (!preg_match('/^(\d{1,2}):(\d{2})(?::(\d{2}))?\s*(am|pm)$/i', $time12, $m)) {
return false;
}
$h = (int)$m[1];
$m = (int)$m[2];
$s = isset($m[3]) ? (int)$m[3] : 0;
$ampm = strtolower($m[4]);
if ($ampm === 'pm' && $h !== 12) $h += 12;
if ($ampm === 'am' && $h === 12) $h = 0;
return sprintf('%02d:%02d:%02d', $h, $m, $s);
}
function to12Hour(string $time24): string|false {
$dt = DateTime::createFromFormat('H:i:s', $time24);
if (!$dt) $dt = DateTime::createFromFormat('H:i', $time24);
return $dt ? $dt->format('h:i:s a') : false;
}
// 14:30:00 -> 02:30:00 pm
// 00:00:00 -> 12:00:00 am
// 12:00:00 -> 12:00:00 pm
統一使用 DateTime::createFromFormat('h:i:s a', ...) 嚴格解析 12 小時制,再 format('H:i:s') 輸出 24 小時制。拒絕 strtotime 的模糊解析,避免邊界情況(12:00 am/pm、無秒格式、非法輸入)產生靜默 Bug。