util.timeAgo 返回 undefined 是因为 Layui 官方 util 模块未提供该方法，仅含 formatDate 等基础函数；需自行实现相对时间计算逻辑或引入第三方库。
util.timeAgo 为什么返回 undefined
因为 util.timeago 不是 layui 内置方法，官方 laydate 和 util 模块里压根没这个函数。很多人搜“layui 时间前”直接抄到不存在的代码，结果调用报 typeerror: util.timeago is not a function。
真实情况是：Layui 2.x 的 util 只提供 util.toDateString、util.formatDate 这类基础格式化，不处理相对时间（如“5秒前”）。想实现“3分钟前”，得自己补逻辑，或引入轻量工具。
- 别在
layui.use(['util'], callback)里找timeAgo—— 它不存在 - 检查你用的是否是第三方魔改版 Layui（比如某些打包了 moment.js 的私有构建），但这种不可靠、不兼容升级
- 原生方案只能靠
new Date()手动算毫秒差，再分段判断
用 util.formatDate + 手动计算实现「X分钟前」
核心思路：拿到时间戳（或 Date 对象）→ 计算与当前时间的毫秒差 → 按阈值分段返回中文描述。这里用 util.formatDate 仅作兜底（当超过 24 小时，退化为日期字符串）。
示例代码（可直接用）：
function timeAgo(timestamp) {
const now = Date.now();
const diff = now - timestamp;
const sec = Math.floor(diff / 1000);
const min = Math.floor(sec / 60);
const hour = Math.floor(min / 60);
const day = Math.floor(hour / 24);
<p>if (sec < 60) return '刚刚';
if (min < 60) return min + '分钟前';
if (hour < 24) return hour + '小时前';
if (day < 7) return day + '天前';
return layui.util.formatDate(timestamp, 'yyyy-MM-dd');
}- 注意传入的
timestamp必须是毫秒级时间戳（13 位），不是秒级（10 位）。若后端给的是1712345678，要先 ×1000 -
layui.util.formatDate不支持时分秒兜底格式（如MM-dd HH:mm），只认固定字符：y/M/d/H/m/s，且大小写敏感 - 该函数不自动节流，高频调用（如列表滚动刷新）建议加防抖或缓存计算结果
和 moment.js 或 dayjs 混用的风险
有人会说：“直接引 dayjs，一行搞定 dayjs().from(timestamp)”。可行，但 Layui 项目里混用要注意：
- Layui 默认用 AMD 加载，而 dayjs 是 ESM/CommonJS，需用
script标签全局引入，或配合layui.config({ paths: {...} })配路径，否则define is not defined - 如果页面已用
laydate，它内部自带轻量日期逻辑，和 dayjs 同时 parse 同一字符串可能因时区/格式歧义出错（例如"2023-05-01"被解析成 UTC 零点还是本地零点） - 压缩后体积：Layui 全量约 300KB，dayjs + 中文包 ≈ 15KB —— 看似小，但对纯内网低带宽系统仍是负担
服务端返回相对时间更稳
前端算相对时间本质是“用客户端时间减服务端时间”，只要用户手机/电脑时间不准，结果就错（比如用户把系统时间调快 2 小时，“3分钟前”会变成“2小时3分钟后”）。
- 推荐后端直接计算：PHP 用
Carbon::parse($time)->diffForHumans()，Node.js 用dayjs().to(dayjs(time))，返回字符串如"3分钟前" - 接口字段命名别用
created_at，改用created_ago或time_desc，语义明确，前端直接插值渲染 - 若必须前端算，至少加一层校验：和服务端 `/api/time` 接口比对时间偏移，动态修正
Date.now()
相对时间看着小，但涉及时区、精度、一致性，最容易在灰度发布时漏测——比如某台测试机系统时间慢了 5 分钟，所有“刚刚”都变成“5分钟前”，问题藏得深，修起来反而花半天。
