函式: DateTimeImmutable::modify()
適用版本: PHP 5 >= 5.5.0, PHP 7
用法: DateTimeImmutable::modify(string $modify) : DateTimeImmutable|false
說明: 修改 DateTimeImmutable 物件的時間。返回一個新的 DateTimeImmutable 物件,原始物件不受影響。
引數:
- modify: 要應用於日期時間的修改字串,可以是任何有效的日期時間格式。
返回值:
- 成功時,返回一個新的 DateTimeImmutable 物件,表示修改後的日期時間。
- 失敗時,返回 false。
示例:
// 建立一個不可變的當前日期時間物件 $datetime = new DateTimeImmutable();
// 輸出原始日期時間 echo '原始日期時間: ' . $datetime->format('Y-m-d H:i:s') . "\n";
// 修改日期時間為兩天後的時間 $modifiedDatetime = $datetime->modify('+2 days');
// 輸出修改後的日期時間 echo '修改後的日期時間: ' . $modifiedDatetime->format('Y-m-d H:i:s') . "\n";
// 使用不同的修改字串修改時間 $modifiedDatetime2 = $datetime->modify('-3 hours');
// 輸出修改後的日期時間 echo '修改後的日期時間(2): ' . $modifiedDatetime2->format('Y-m-d H:i:s') . "\n";
輸出: 原始日期時間: 2022-01-01 12:00:00 修改後的日期時間: 2022-01-03 12:00:00 修改後的日期時間(2): 2022-01-01 09:00:00