HOWTO · PHP
如何在 PHP 中获取时间差的分钟数
本文介绍了如何在 PHP 中获取时间差的分钟数,包括 date_diff()函数和数学公式。它包括 date_diff()函数和数学公式。
本页内容
要计算两个 PHP 日期时间值之间经过的分钟数,可以先相减它们的 Unix 时间戳,再将秒数除以 60。需要计算持续时间时,适合使用这种方法。需要日历间隔时使用 date_diff();输入是可解析的字符串时,使用 strtotime()。两个值应处于相同的时区上下文中,并根据需要决定保留差值的方向,还是只取其绝对值。
根据时间戳计算经过的分钟数
DateTimeImmutable 能明确表示输入值,并避免在计算过程中修改它们。请为两个值都设置时区;示例使用 UTC。相减时间戳会得到带符号的经过秒数,因此结束值较晚时结果为正,符号也取决于相减顺序。只有在不关心方向时,才用 abs() 包裹差值。除以 60 会保留小数分钟;只有应用要求整数分钟时,才使用舍入函数。
运行以下示例(其中的输出标签仍为英文):
<?php
$timezone = new DateTimeZone('UTC');
$start = new DateTimeImmutable('2024-06-16 09:15:00', $timezone);
$end = new DateTimeImmutable('2024-06-16 10:00:00', $timezone);
$elapsedMinutes = ($end->getTimestamp() - $start->getTimestamp()) / 60;
echo "Elapsed minutes: $elapsedMinutes\n";
要计算跨越夏令时变更的实际经过时间,请使用具有预期时区的日期时间值所对应的时间戳。在实行夏令时的时区中,不要假定每个日历日都恰好包含 1,440 分钟的实际经过时间。
使用 date_diff() 计算日历日期差异
date_diff()(也可通过 $start->diff($end) 调用)会返回 DateInterval,而不是一个表示经过分钟数的单一数值。当问题采用日历时间的表述时,例如“相差多少天、小时和分钟?”,它的天、小时和分钟部分就很有用。如果结束时间早于开始时间,间隔的 invert 属性会表示方向;absolute 参数则可用于忽略方向。
本节中的代码以及显示的标签或输出仍为英文。
<?php
$timezone = new DateTimeZone('UTC');
$start = new DateTimeImmutable('2024-06-16 09:15:00', $timezone);
$end = new DateTimeImmutable('2024-06-18 12:30:00', $timezone);
$interval = date_diff($start, $end);
echo $interval->format('%R%a days, %h hours, and %i minutes');
对于日历间隔,可以用其组成部分计算名义上的分钟数:$interval->days * 1440 + $interval->h * 60 + $interval->i。这个计算会合并日历天数和时钟部分;如果需要准确计算跨时区转换的实际经过分钟数,它不能替代时间戳相减。若方向很重要,请保留间隔的符号,或使用 $interval->invert 将方向应用于计算出的绝对值。
使用 strtotime() 解析时间字符串
strtotime() 会将可解析的日期时间字符串转换为 Unix 时间戳。仅包含时间的字符串会根据某个日期上下文进行解释;如果输入可能跨越午夜或属于不同日期,请提供完整日期。请明确设置默认时区,或在每个字符串中包含时区,以确保两个时间戳都采用预期的时区上下文。下面的相减运算会保留结果的正负方向;若要得到无符号的持续时间,请使用 abs()。
本节中的代码以及显示的标签或输出仍为英文。
<?php
date_default_timezone_set('UTC');
$start = strtotime('2024-06-16 23:30:00 UTC');
$end = strtotime('2024-06-17 00:15:00 UTC');
$minutes = ($end - $start) / 60;
echo "Elapsed minutes: $minutes\n";
解析不可信或格式不固定的输入时,请在相减前检查每次调用是否都返回了时间戳;解析可能失败并返回 false。对于需要明确处理时区的应用数据,建议使用显式时区构造 DateTimeImmutable 值。需要简洁地解析字符串时使用 strtotime();需要计算实际经过的持续时间时相减时间戳;需要描述日历间隔本身时使用 date_diff()。