萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 实现人性化相对时间显示函数(如“3分钟前”、“2小时前”)

需求背景

在社交动态、评论列表、日志记录等场景,直接展示标准时间格式(如 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
?>

参数详解

参数类型默认值说明
$timeint|string|falsefalse目标时间,支持时间戳、strtotime 可解析字符串,省略则为当前时间
$limitint86400阈值(秒),超过则改用 $format 格式化输出
$formatstring'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);
}

性能与注意事项

  • 函数纯计算,无 I/O,性能极高,可直接在模板循环中调用
  • 注意时区一致性:建议在入口文件统一设置 date_default_timezone_set('PRC')
  • 若需精确到“刚刚/几秒前”,可在 $diff < 10 时返回“刚刚”

将此函数放入公共工具类或 Helper 文件,即可全项目复用,提升用户体验。

copyright © 萬盛學電腦網 all rights reserved