萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 12 小時制轉 24 小時制的標準方法與陷阱避坑

需求

前端傳遞 02:30:00 pm 格式時間,後端需統一轉為 24 小時制 14:30:00 存儲或比較。

推薦做法:DateTime 物件(PHP 5.2+)

<?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)

為什麼不用 strtotime()?

<?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,安全得多。

舊版兼容寫法(PHP 5.1-)

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);
}

反向轉換:24 → 12 小時制

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。

copyright © 萬盛學電腦網 all rights reserved