date_sub 和date_add 函數有哪些區別？如何联合使用這兩個函數？

gitbox 2025-09-30

1. date_add()函數

date_add()函數用於將一個時間間隔添加到一個DateTime對像中。它接受兩個參數：一個DateTime對象和一個表示時間間隔的DateInterval對象。時間間隔可以是年、月、日、小時、分鐘等單位的組合。

文法:

 <span><span><span class="hljs-title function_ invoke__">date_add</span></span><span>(DateTime </span><span><span class="hljs-variable">$datetime</span></span><span>, DateInterval </span><span><span class="hljs-variable">$interval</span></span><span>): DateTime
</span></span>

參數：

$datetime ：要進行加法操作的DateTime對象。
$interval ：一個DateInterval對象，表示需要添加的時間間隔。

示例：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$datetime</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">DateTime</span></span><span>(</span><span><span class="hljs-string">'2025-01-01'</span></span><span>);
</span><span><span class="hljs-variable">$interval</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">DateInterval</span></span><span>(</span><span><span class="hljs-string">'P1D'</span></span><span>);  </span><span><span class="hljs-comment">// 添加1天</span></span><span>
</span><span><span class="hljs-title function_ invoke__">date_add</span></span><span>(</span><span><span class="hljs-variable">$datetime</span></span><span>, </span><span><span class="hljs-variable">$interval</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$datetime</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">format</span></span><span>(</span><span><span class="hljs-string">'Y-m-d'</span></span><span>);  </span><span><span class="hljs-comment">// 輸出: 2025-01-02</span></span><span>
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在上述代碼中，我們創建了一個DateTime對象並初始化為'2025-01-01' ，然後我們創建一個DateInterval對象表示“加1天”，最後通過date_add()函數將時間間隔添加到日期中。

2. date_sub()函數

與date_add()相反， date_sub()函數用於從DateTime對像中減去一個時間間隔。它的功能與date_add()基本相同，但作用是減少時間，而不是增加。

文法:

 <span><span><span class="hljs-title function_ invoke__">date_sub</span></span><span>(DateTime </span><span><span class="hljs-variable">$datetime</span></span><span>, DateInterval </span><span><span class="hljs-variable">$interval</span></span><span>): DateTime
</span></span>

參數：

$datetime ：要進行減法操作的DateTime對象。
$interval ：一個DateInterval對象，表示需要減去的時間間隔。

示例：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$datetime</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">DateTime</span></span><span>(</span><span><span class="hljs-string">'2025-01-01'</span></span><span>);
</span><span><span class="hljs-variable">$interval</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">DateInterval</span></span><span>(</span><span><span class="hljs-string">'P1D'</span></span><span>);  </span><span><span class="hljs-comment">// 減去1天</span></span><span>
</span><span><span class="hljs-title function_ invoke__">date_sub</span></span><span>(</span><span><span class="hljs-variable">$datetime</span></span><span>, </span><span><span class="hljs-variable">$interval</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$datetime</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">format</span></span><span>(</span><span><span class="hljs-string">'Y-m-d'</span></span><span>);  </span><span><span class="hljs-comment">// 輸出: 2024-12-31</span></span><span>
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在這個示例中，我們同樣創建了一個DateTime對象並初始化為'2025-01-01' ，然後創建一個DateInterval對象表示“減1天”，通過date_sub()函數將時間間隔從日期中減去。

3. date_add()與date_sub()的區別

功能上的區別： date_add()用於將時間間隔加到日期上，而date_sub()用於將時間間隔從日期中減去。
參數順序：雖然這兩個函數的參數順序和用法基本相同，但它們的效果正好相反。 date_add()是進行加法操作， date_sub()是進行減法操作。

4. 如何联合使用date_add()和date_sub() ？

有時候，在處理複雜的日期運算時，我們可能需要同時使用date_add()和date_sub()來對一個日期進行多個不同的時間操作。例如，某個日期首先要加上兩個月，然後再減去一個星期。我們可以將這兩個函數聯合使用來實現這個需求。

示例：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$datetime</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">DateTime</span></span><span>(</span><span><span class="hljs-string">'2025-01-01'</span></span><span>);

</span><span><span class="hljs-comment">// 第一步，添加2個月</span></span><span>
</span><span><span class="hljs-variable">$interval_add</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">DateInterval</span></span><span>(</span><span><span class="hljs-string">'P2M'</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">date_add</span></span><span>(</span><span><span class="hljs-variable">$datetime</span></span><span>, </span><span><span class="hljs-variable">$interval_add</span></span><span>);

</span><span><span class="hljs-comment">// 第二步，減去1個星期</span></span><span>
</span><span><span class="hljs-variable">$interval_sub</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">DateInterval</span></span><span>(</span><span><span class="hljs-string">'P1W'</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">date_sub</span></span><span>(</span><span><span class="hljs-variable">$datetime</span></span><span>, </span><span><span class="hljs-variable">$interval_sub</span></span><span>);

</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$datetime</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">format</span></span><span>(</span><span><span class="hljs-string">'Y-m-d'</span></span><span>);  </span><span><span class="hljs-comment">// 輸出: 2025-03-04</span></span><span>
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在這個例子中，我們首先使用date_add()將日期加上了兩個月，然後使用date_sub()從結果中減去了一個星期。最終的結果是'2025-03-04' 。

5. 使用date_add()和date_sub()的常見場景

計算未來或過去的日期：如果你需要計算未來或過去某個日期，可以利用date_add()和date_sub()進行加減操作。
處理日期和時間差：這些函數在計算某個日期與當前日期之間的差值時非常有用。通過先使用date_add()或date_sub()來調整日期，再進行比較，可以有效解決複雜的日期運算問題。
定時任務和日程安排：在一些自動化任務中，可能需要根據特定的時間間隔調整任務的執行時間。 date_add()和date_sub()可以靈活地為每個任務設置不同的時間點。