在社交动态、评论列表、日志记录等场景,直接展示标准时间格式(如 2024-05-18 14:30)不够直观。用户更习惯看到“刚刚”、“5分钟前”、“昨天 10:00”等相对时间。本文提供一个健壮、可复用的 PHP 函数 relativeTime() 实现该需求。
<?php
/**
* 将时间戳转换为人性化相对时间字符串
*
* @param int|string|false $time 目标时间(时间戳、可解析字符串或 false 表示当前时间)
* @param int $limit 超过该秒数则显示完整格式化时间,默认 86400(1天)
* @param string $format 超过 limit 时使用的日期格式,默认 'g:i A M jS'
* @return string 相对时间描述
*/
function relativeTime($time = false, $limit = 86400, $format = 'g:i A M jS') {
// 标准化输入时间
if (empty($time) || (!is_string($time) && !is_numeric($time))) {
$time = time();
} elseif (is_string($time)) {
$time = strtotime($time);
}
$now = time();
// 同一秒
if ($time === $now) return 'now';
// 未来时间
if ($time > $now) return 'in the future';
$diff = $now - $time;
// 超过阈值,显示完整格式
if ($diff >= $limit) {
return date($format, $time);
}
// 1 分钟内
if ($diff < 60) {
return 'less than one minute ago';
}
// 分钟级
$minutes = ceil($diff / 60);
if ($minutes < 60) {
return $minutes . ' minute' . ($minutes === 1 ? '' : 's') . ' ago';
}
// 小时级
$hours = ceil($diff / 3600);
return 'about ' . $hours . ' hour' . ($hours === 1 ? '' : 's') . ' ago';
}
// 使用示例
echo relativeTime(strtotime('-30 seconds')); // less than one minute ago
echo relativeTime(strtotime('-5 minutes')); // 5 minutes ago
echo relativeTime(strtotime('-2 hours')); // about 2 hours ago
echo relativeTime(strtotime('-3 days')); // 3:00 PM May 15th (超过 1 天)
echo relativeTime('2024-01-01 12:00:00'); // 12:00 PM Jan 1st
?>
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| $time | int|string|false | false | 目标时间,支持时间戳、strtotime 可解析字符串,省略则为当前时间 |
| $limit | int | 86400 | 阈值(秒),超过则改用 $format 格式化输出 |
| $format | string | 'g:i A M jS' | 完整时间格式,遵循 date() 规则 |
若项目面向中文用户,可直接替换返回字符串:
function relativeTimeCN($time = false, $limit = 86400, $format = 'Y-m-d H:i') {
// ... 标准化 $time 同前 ...
if ($diff < 60) return '刚刚';
if ($minutes < 60) return $minutes . '分钟前';
if ($hours < 24) return $hours . '小时前';
if ($diff < $limit) return $hours . '小时前'; // 或按天计算
return date($format, $time);
}
date_default_timezone_set('PRC')$diff < 10 时返回“刚刚”将此函数放入公共工具类或 Helper 文件,即可全项目复用,提升用户体验。