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() 可以灵活地为每个任务设置不同的时间点。