萬盛學電腦網

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

PHP date_parse() 函數詳解:日期字符串解析為結構化數組

函數定義

date_parse(string $date): array|false

將日期/時間字符串解析為結構化關聯數組,支援所有 strtotime() 接受的格式。PHP 5.2+ 可用。

返回數組結構

Array
(
    [year]         => int      // 年
    [month]        => int      // 月
    [day]          => int      // 日
    [hour]         => int      // 時
    [minute]       => int      // 分
    [second]       => int      // 秒
    [fraction]     => float    // 微秒部分
    [warning_count] => int     // 警告數量
    [warnings]     => array    // 警告詳情
    [error_count]  => int      // 錯誤數量
    [errors]       => array    // 錯誤詳情
    [is_localtime] => bool     // 是否本地時間
)

基本用法示例

$parsed = date_parse("2016/1/11 10:05:50");
print_r($parsed);
/*
Array
(
    [year] => 2016
    [month] => 1
    [day] => 11
    [hour] => 10
    [minute] => 5
    [second] => 50
    [fraction] => 0
    [warning_count] => 0
    [warnings] => Array()
    [error_count] => 0
    [errors] => Array()
    [is_localtime] => 
)
*/

支援格式豐富

// 相對時間
date_parse("next Thursday");
date_parse("+1 week 2 days");

// ISO 8601
date_parse("2024-12-25T14:30:00+08:00");

// 美式/英式
date_parse("12/25/2024");
date_parse("25 Dec 2024");

// 非標準
date_parse("2024年12月25日 14時30分"); // 需 intl 擴展

實戰應用:時間字符串轉秒數

function timeToSeconds($timeStr) {
    $p = date_parse($timeStr);
    if ($p['error_count']) return false;
    return ($p['hour'] ?? 0) * 3600 
         + ($p['minute'] ?? 0) * 60 
         + ($p['second'] ?? 0);
}

echo timeToSeconds('21:30:10'); // 77410
echo timeToSeconds('1:05:03');  // 3903

錯誤與警告處理

$result = date_parse("2024-13-45 25:70:80");
if ($result['error_count']) {
    echo "Errors:\n";
    print_r($result['errors']);
}
if ($result['warning_count']) {
    echo "Warnings:\n";
    print_r($result['warnings']);
}
/*
Errors:
Array
(
    [0] => The parsed date was invalid
)
Warnings:
Array
(
    [0] => The parsed date was invalid
    [1] => The parsed date was invalid
)
*/

對比:date_parse vs DateTime vs strtotime

特性date_parse()DateTime::createFromFormat()strtotime()
返回類型結構化數組DateTime 對象 / false時間戳 / false
格式控制自動檢測**指定格式**自動檢測
錯誤詳情**詳細 warnings/errorsgetLastErrors()無
時區處理is_localtime 標識完整支援依賴默認時區
性能中等較慢(對象開銷)快

適用場景建議

  • 需拆解日期組件: date_parse() 最直接
  • 需格式驗證/轉換: DateTime::createFromFormat()
  • 需時間戳/運算: strtotime()
  • 需錯誤詳情提示用戶: date_parse() 的 warnings/errors

注意事項

  1. 返回 false 表示完全解析失敗
  2. fraction 為浮點數,如 10.5 秒 → 0.5
  3. 不包含時區信息,is_localtime 僅標識是否本地時間
  4. PHP 7.3+ 微秒精度更準確
copyright © 萬盛學電腦網 all rights reserved