萬盛學電腦網

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

PHP strptime() 函數詳解:依指定格式解析日期時間字串

函數用途

strptime() 依指定格式解析日期/時間字串,回傳結構化陣列。與 strftime() 互為逆操作。注意:Windows 平台不支援此函數。

語法與參數

strptime(string $date, string $format): array|false
參數說明
$date必填,待解析的日期時間字串
$format必填,格式字串(參考 strftime() 格式代碼)

回傳陣列鍵名說明

鍵名含義範圍
tm_sec秒0-61
tm_min分0-59
tm_hour時(24 小時制)0-23
tm_mday月份中的第幾天1-31
tm_mon月份(自 1 月起算)0-11
tm_year年份(自 1900 年起算)如 105 代表 2005
tm_wday星期幾(自星期日)0-6
tm_yday年間第幾天0-365
unparsed未被格式識別的剩餘字串-

常用格式代碼

  • %d 月份中的天數 (01-31)、%m 月份 (01-12)、%Y 四位數年份
  • %H 24小時制 (00-23)、%M 分鐘 (00-59)、%S 秒 (00-59)
  • %A 完整星期名稱、%B 完整月份名稱

實戰範例

<?php
$format = "%d/%m/%Y %H:%M:%S";
$strf = strftime($format);  // 產生當前時間字串
echo "格式化時間: $strf\n";

$parsed = strptime($strf, $format);
print_r($parsed);
/*
Array
(
    [tm_sec] => 44
    [tm_min] => 23
    [tm_hour] => 13
    [tm_mday] => 3
    [tm_mon] => 9
    [tm_year] => 105
    [tm_wday] => 0
    [tm_yday] => 276
    [unparsed] =>
)
*/
?>

注意事項

  • Windows 不支援,跨平台專案建議改用 DateTime::createFromFormat()。
  • 解析失敗回傳 false。
  • 格式字串需與輸入字串完全對應,否則會有 unparsed 剩餘內容。

現代替代方案:DateTime::createFromFormat()

<?php
$dateStr = "03/10/2005 13:23:44";
$dt = DateTime::createFromFormat("d/m/Y H:i:s", $dateStr);
if ($dt) {
    echo $dt->format("Y-m-d H:i:s");  // 2005-10-03 13:23:44
}
?>

DateTime 類別提供更強大、跨平台一致的日期時間處理能力,新專案優先採用。

copyright © 萬盛學電腦網 all rights reserved