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

Time\Duration::compare · Compares two durations

· 52CE 我爱测

Time\Duration::compare — Compares two durations

Time\Duration::compare

(PHP 8 >= 8.6.0)

Time\Duration::compare — Compares two durations

Description

public static function Time\Duration::compare(Time\Duration $a, Time\Duration $b): int

Compares the durations a and b, taking their signs into account. The return value is suitable as the result of a callback for usort().

The same ordering is used by the comparison operators when both operands are Time\Duration objects.

Parameters

a

The first duration.

b

The second duration.

Return Values

Returns a value less than 0 if a is shorter than b, a value greater than 0 if a is longer than b, and 0 if both durations are equal. No particular meaning can be reliably inferred from the value aside from its sign. Negative durations are always smaller than positive ones.

Examples

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

<?php
$oneSecond = \Time\Duration::fromSeconds(1);
$oneAndAHalfSeconds = \Time\Duration::fromMilliseconds(1500);
$billionNanoseconds = \Time\Duration::fromNanoseconds(1_000_000_000);

var_dump(\Time\Duration::compare($oneSecond, $oneAndAHalfSeconds) < 0);
var_dump(\Time\Duration::compare($oneAndAHalfSeconds, $oneSecond) > 0);
var_dump(\Time\Duration::compare($oneSecond, $billionNanoseconds) === 0);

// Negative durations are smaller than positive ones.
var_dump(\Time\Duration::compare($oneSecond->negate(), $oneSecond) < 0);

The above example will output:

bool(true)
bool(true)
bool(true)
bool(true)

Example #2 Sorting durations with Time\Duration::compare()

<?php
$durations = [
    \Time\Duration::fromMinutes(2),
    \Time\Duration::fromMilliseconds(250),
    \Time\Duration::fromSeconds(5),
];

usort($durations, \Time\Duration::compare(...));

foreach ($durations as $duration) {
    printf("%d.%09d\n", $duration->seconds, $duration->nanoseconds);
}

The above example will output:

0.250000000
5.000000000
120.000000000

See Also

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

资料来源与适用范围

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

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

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