PHP Conference Japan 2024

DateTimeImmutable::add

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

DateTimeImmutable::add 傳回一個新的物件,加上指定的天數、月數、年數、小時數、分鐘數和秒數

描述

public DateTimeImmutable::add(DateInterval $interval): DateTimeImmutable

建立一個新的 DateTimeImmutable 物件,並將指定的 DateInterval 物件加到此物件,以表示新的值。

參數

interval

一個 DateInterval 物件

返回值

返回一個包含修改後資料的新 DateTimeImmutable 物件。

範例

範例 #1 DateTimeImmutable::add() 範例

物件導向風格

<?php
$date
= new DateTimeImmutable('2000-01-01');
$newDate = $date->add(new DateInterval('P10D'));
echo
$newDate->format('Y-m-d') . "\n";
?>

範例 #2 更多 DateTimeImmutable::add() 範例

<?php
$date
= new DateTimeImmutable('2000-01-01');
$newDate = $date->add(new DateInterval('PT10H30S'));
echo
$newDate->format('Y-m-d H:i:s') . "\n";

$date = new DateTimeImmutable('2000-01-01');
$newDate = $date->add(new DateInterval('P7Y5M4DT4H3M2S'));
echo
$newDate->format('Y-m-d H:i:s') . "\n";
?>

以上範例將輸出

2000-01-01 10:00:30
2007-06-05 04:03:02

範例 #3 新增月份時要注意

<?php
$date
= new DateTimeImmutable('2000-12-31');
$interval = new DateInterval('P1M');

$newDate1 = $date->add($interval);
echo
$newDate1->format('Y-m-d') . "\n";

$newDate2 = $newDate1->add($interval);
echo
$newDate2->format('Y-m-d') . "\n";
?>

以上範例將輸出

2001-01-31
2001-03-03

另請參閱

新增註釋

使用者提供的註釋

此頁面沒有使用者提供的註釋。
To Top