date_interval_create_from_date_string()函式—用法及示例

函式名稱：date_interval_create_from_date_string() 函式描述：該函式用於建立一個日期間隔物件，透過解析字串表示的日期間隔。

適用版本：>= PHP 5.3.0

用法： date_interval_create_from_date_string(string $time) : DateInterval|false

引數：

• $time：表示日期間隔的字串，必須遵循以下格式：PnYnMnDTnHnMnS（其中n表示數字，nY代表年份，nM代表月份，nD代表天數，nH代表小時數，nM代表分鐘數，nS代表秒數）。

返回值：

• 如果成功建立了日期間隔物件，則返回DateInterval物件。
• 如果傳遞的時間字串無效，則返回false。

示例：

// 建立一個表示30分鐘的日期間隔物件
$interval = date_interval_create_from_date_string('30 minutes');

// 輸出間隔的小時數和分鐘數
echo $interval->format('%h hours, %i minutes');  // 輸出: 0 hours, 30 minutes

// 建立一個表示1天5小時的日期間隔物件
$interval = date_interval_create_from_date_string('1 day 5 hours');

// 輸出間隔的天數和小時數
echo $interval->format('%d days, %h hours');  // 輸出: 1 days, 5 hours

// 建立一個無效的日期間隔物件
$interval = date_interval_create_from_date_string('invalid'); 

if ($interval === false) {
    echo '無效的時間字串';
}

注意事項：

• 日期間隔物件用於表示一個時間段，可以用於做日期運算和操作。
• 時間字串必須遵循ISO 8601標準，否則將被視為無效。
• 時間字串的每個部分都是可選的，如果沒有提供則預設為0。
• 日期間隔物件的格式化可以使用DateInterval的format()方法進行自定義輸出。
• 如果傳遞的時間字串無效，函式將返回false，因此建議使用條件語句來檢查返回值是否為false。