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() | DateTime::createFromFormat() | strtotime() |
|---|---|---|---|
| 返回類型 | 結構化數組 | DateTime 對象 / false | 時間戳 / false | 格式控制 | 自動檢測 | **指定格式** | 自動檢測 |
| 錯誤詳情 | **詳細 warnings/errors | getLastErrors() | 無 |
| 時區處理 | is_localtime 標識 | 完整支援 | 依賴默認時區 |
| 性能 | 中等 | 較慢(對象開銷) | 快 |
false 表示完全解析失敗fraction 為浮點數,如 10.5 秒 → 0.5is_localtime 僅標識是否本地時間