Intl.RelativeTimeFormat 不自动实时更新,需手动调用 format();它纯函数式、无状态,仅保存 locale 和 style 配置,不绑定时间;计算 timeDiff 应用阈值阶梯法而非简单除法;SSR 时需注意 Node ICU 数据完整性及降级策略。

Intl.RelativeTimeFormat 不能自动实时更新,必须手动触发
这个 API 本身是纯函数式、无状态的,调用 format() 只返回一个静态字符串,比如 "2 minutes ago"。它不会监听时间流逝,也不会 setInterval 自动重算。想让“2分钟前”变成“3分钟前”,你得自己在合适时机重新调用 format()。
常见错误是以为构造一次 Intl.RelativeTimeFormat 实例就能“绑定”到当前时间——实际它只记住了 locale 和 style 配置,不存任何时间引用。
- 每次显示新值前,都要用当前时间(
Date.now())减去目标时间戳,算出带符号的数值和单位(如-2和"minute") - 单位必须严格匹配:用
"second"就不能传"seconds",否则返回原始数字而非相对描述 - 负数表示过去,正数表示将来(如
1+"day"→"in 1 day")
如何计算 timeDiff 并选对单位才不翻车
直接用 (Date.now() - timestamp) / 1000 得到秒数再取整?不行——这会丢失精度,且跨单位换算(分→时→天)容易漏边界。推荐用预设阈值阶梯判断:
function getRelativeParts(timestamp) {
const diffMs = Date.now() - timestamp;
if (Math.abs(diffMs) < 5000) return { value: 0, unit: "second" };
if (Math.abs(diffMs) < 60 * 1000) return { value: Math.round(diffMs / 1000), unit: "second" };
if (Math.abs(diffMs) < 60 * 60 * 1000) return { value: Math.round(diffMs / (60 * 1000)), unit: "minute" };
if (Math.abs(diffMs) < 24 * 60 * 60 * 1000) return { value: Math.round(diffMs / (60 * 60 * 1000)), unit: "hour" };
return { value: Math.round(diffMs / (24 * 60 * 60 * 1000)), unit: "day" };
}注意:value 必须是整数,且单位名必须小写、单数("day" 不是 "days"),否则 format() 会 fallback 到数字原样输出。
React 中每分钟更新一次的轻量实现
不用 useEffect + setInterval 每秒刷——太浪费。社交动态的时间粒度通常到“分钟”就够了,每 60s 更新一次即可。关键点:
- 用
useRef缓存Intl.RelativeTimeFormat实例,避免重复构造 - 用
useMemo把时间计算和格式化收拢,依赖项只含timestamp和tick(每分钟自增的 ref) - 清理定时器,防止组件卸载后仍触发
setState
示例片段:
const rtf = useRef(new Intl.RelativeTimeFormat("zh-CN", { numeric: "auto" }));
const [tick, setTick] = useState(0);
useEffect(() => {
const timer = setInterval(() => setTick(t => t + 1), 60 * 1000);
return () => clearInterval(timer);
}, []);
const relative = useMemo(() => {
const { value, unit } = getRelativeParts(timestamp);
return rtf.current.format(value, unit);
}, [timestamp, tick]);服务端渲染(SSR)时的坑:locale 和数字系统不一致
Node.js 环境默认不支持所有 Intl 语言数据,尤其像 "zh-CN" 的农历或复杂复数规则。V8 早期版本甚至对 numeric: "auto" 返回 "1 day ago" 而非 "1天前"。
验证方法:在 Node 中直接运行 new Intl.RelativeTimeFormat("zh-CN").format(-1, "day"),看是否报错或返回英文。
- 生产环境务必检查 Node 版本(≥18.17 推荐),并启用
--icu-data-dir或使用full-icu包 - 若无法保证 ICU 数据完整,降级策略:SSR 阶段用简单中文模板(
${n} ${unit}前),CSR 后再用Intl覆盖 -
style: "short"比"long"更轻量,但 iOS Safari 对"short"支持滞后,需测试
最易被忽略的是:不同设备的 Intl 实现差异比想象中大,哪怕同是 Chrome,Android WebView 和桌面版对 “just now” 的阈值判定都可能不同。上线前一定拿真机测几个典型时间差(30s、59s、61s、23h59m)。

















