大网数据广告活动
PHP 语言与运行手册

Time\Duration::sub · Subtracts a duration

· 52CE 我爱测

Returns the difference between this duration and duration. The signs of both durations are taken into account, so subtracting a negative duration lengthens a positive one. If duration is longer than this duration, the result is negative.

Time\Duration::sub

(PHP 8 >= 8.6.0)

Time\Duration::sub — Subtracts a duration

Description

public function Time\Duration::sub(Time\Duration $duration): Time\Duration

Returns the difference between this duration and duration. The signs of both durations are taken into account, so subtracting a negative duration lengthens a positive one. If duration is longer than this duration, the result is negative.

Parameters

duration

The duration to subtract.

Return Values

Returns a new Time\Duration object.

Errors/Exceptions

Examples

Example #1 Time\Duration::sub() example

<?php
var_dump(\Time\Duration::fromSeconds(10)->sub(\Time\Duration::fromMilliseconds(2500)));

// Subtracting a larger duration results in a negative duration.
var_dump(\Time\Duration::fromSeconds(1)->sub(\Time\Duration::fromSeconds(3)));

The above example will output:

object(Time\Duration)#3 (3) {
  ["seconds"]=>
  int(7)
  ["nanoseconds"]=>
  int(500000000)
  ["negative"]=>
  bool(false)
}
object(Time\Duration)#1 (3) {
  ["seconds"]=>
  int(2)
  ["nanoseconds"]=>
  int(0)
  ["negative"]=>
  bool(true)
}

See Also

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。