HOWTO · PHP
如何在 PHP 中將字串轉換為日期和日期時間
使用幾種 PHP 函式將字串轉換為日期或日期時間,例如組合使用 strtotime 和 date,或使用 DateTime::createFromFormat() 或 date_create_from_format()。
本頁內容
日期字串在 PHP 解析之前都只是文字。解析會將文字解讀為時間戳記或日期時間物件;格式化則會把解析後的值轉成應用程式需要的表示方式。若輸入是常見且沒有歧義的日期表示法,可使用 strtotime()。若輸入符合已知模式,建議使用 DateTime::createFromFormat() 指定格式,或使用其程序式對應函式 date_create_from_format()。
選擇合適的 PHP 日期解析方式
若可接受彈性解讀,常見字串(例如 ISO 格式的日期)適合使用 strtotime()。它會傳回 Unix 時間戳記或 false,而 date() 可用來格式化時間戳記。若輸入格式固定,DateTime::createFromFormat() 方法可明確指定欄位順序,並傳回日期時間物件或 false。程序式的 date_create_from_format() 函式也提供相同的解析方式,不必直接呼叫靜態方法。
這些函式無法消除輸入本身的歧義。如果使用者可能依不同慣例輸入日期,請在接收輸入時明確規定預期格式並加以驗證。無論使用哪種方法,解讀日期時間時都應審慎選擇時區;否則 PHP 會使用已設定的預設時區。
使用 strtotime() 和 date() 解析彈性日期字串
若輸入是常見的日期時間字串,可使用 strtotime() 解析,再將傳回的時間戳記交給 date()。格式化前請先檢查結果是否為 false,避免將解析失敗的結果當成時間戳記使用。此範例使用固定的輸入和輸出格式,因此不受執行機器目前時間影響,結果可以重現。
執行此範例:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
<?php
$dateString = '2023-10-15 14:30:00';
$timestamp = strtotime($dateString);
if ($timestamp === false) {
echo "Could not parse the date string.";
} else {
echo date('Y-m-d H:i:s', $timestamp);
}
strtotime() 接受許多日期文字表示法,但這種彈性不能取代明確指定輸入格式。解析結果代表依時區規則解讀的一個時間點;date() 則會使用 PHP 的預設時區格式化時間戳記。如果來源有已知時區,請明確寫入或套用該時區,不要依賴伺服器設定。
使用 DateTime::createFromFormat() 解析已知格式
若字串具有明確格式,請提供相符的格式字串。在下方格式中,d、m、Y、H 和 i 分別代表日、月、四位數年份、小時和分鐘。開頭的 ! 會重設輸入中未包含的欄位,不會沿用目前日期的秒數或其他欄位。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
<?php
$dateString = '15-10-2023 14:30';
$dateFormat = '!d-m-Y H:i';
$dateTime = DateTime::createFromFormat($dateFormat, $dateString);
if ($dateTime === false) {
echo "Could not parse the date string.";
} else {
echo $dateTime->format('Y-m-d H:i:s');
}
格式字串必須描述輸入內容,而不是預期的輸出格式。解析後,請呼叫 format() 並提供所需的輸出格式。結果不是 false,並不代表每個日期欄位都已完全依預期接受:PHP 可能會將部分超出範圍的數值正規化,並回報警告。若要嚴格驗證輸入,請在解析後檢查 DateTime::getLastErrors(),下方會進一步說明。
使用程序式的 date_create_from_format() 函式
如果程式碼已使用 PHP 的日期函式,程序式函式會很實用。它接受相同的輸入格式和字串,成功時傳回 DateTime 物件,解析失敗時則傳回 false。請先確認傳回值是物件,再使用 date_format() 格式化。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
<?php
$dateString = '2023/10/15 14:30';
$dateFormat = '!Y/m/d H:i';
$dateTime = date_create_from_format($dateFormat, $dateString);
if ($dateTime === false) {
echo "Could not parse the date string.";
} else {
echo date_format($dateTime, 'Y-m-d H:i:s');
}
這是 DateTime::createFromFormat() 的程序式替代方式:兩者都會依照提供的格式解析,並產生 DateTime 物件。請依周邊程式碼的風格選擇。選擇兩者時不必依據 PHP 版本;若要確認 API 是否可用,請查閱應用程式所支援 PHP 版本的文件。
處理有歧義的輸入、解析錯誤和時區
像 03/04/2023 這樣的字串,可能代表 3 月 4 日或 4 月 3 日,取決於採用的日期慣例。不要只靠分隔符判斷其意義。如果來源格式已知,請將確切格式傳給 DateTime::createFromFormat(),並驗證解析結果。對於符合慣例且格式明確的字串,strtotime() 使用起來很方便,但它無法推斷使用者採用哪種日期慣例。
DateTime::createFromFormat() 和 date_create_from_format() 都可能傳回 false;呼叫物件方法或 date_format() 之前,請先檢查結果。即使解析接受了某個值,也可能同時回報警告,例如 PHP 將某個日期欄位正規化的情況。若日期必須完全有效,也請檢查解析診斷資訊:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
<?php
$dateTime = DateTime::createFromFormat('!Y-m-d', '2023-02-31');
$errors = DateTime::getLastErrors();
if ($dateTime === false || ($errors !== false && ($errors['warning_count'] > 0 || $errors['error_count'] > 0))) {
echo "The date is not valid for the specified format.";
} else {
echo $dateTime->format('Y-m-d');
}
! 會重設未指定的欄位,而 getLastErrors() 會回報最近一次解析的警告與錯誤。不同 PHP 版本提供的診斷細節可能不同,因此請在應用程式支援的版本上測試驗證規則。若日期時間屬於特定地區,請為該地區建立 DateTimeZone,並將它作為第三個引數傳給 DateTime::createFromFormat()(或傳給程序式函式對應的時區引數)。如果輸入包含明確的 UTC 位移量,請在顯示前依需求保留或轉換該位移量。