讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

动态显示“Last Refreshed X ago”倒计时的前端实现方案

秋磊姑娘_8296

秋磊姑娘_8296

发布时间:2026-03-11 14:33:13

|

886人浏览过

|

来源于php中文网

原创

本文详解如何在网页中稳定、连续地显示“last refreshed x ago”动态时间戳,支持页面刷新不重置、5分钟周期自动归零,并兼容秒/分单位智能切换。

本文详解如何在网页中稳定、连续地显示“last refreshed x ago”动态时间戳,支持页面刷新不重置、5分钟周期自动归零,并兼容秒/分单位智能切换。

在构建实时数据看板(如 Twitter 热搜趋势)时,一个关键的用户体验细节是准确、可信地展示数据新鲜度——例如 “Last Refreshed 2 min ago”。但若仅依赖 Date.now() 在页面加载时初始化计时器,将导致两个典型问题:(1)浏览器刷新后倒计时重置为 0;(2)API 实际已更新,但前端计时器仍持续累加,超出 5 分钟后失去业务意义。

根本解法在于:将“最后一次成功刷新数据的时间点”持久化存储于客户端,并以此为基准实时计算相对时长。localStorage 是最轻量、可靠且无需服务端改造的选择——它跨会话保留数据,且读写性能优异。

✅ 核心实现逻辑

  1. 初始化时间戳:首次加载时,若 localStorage 中无 startTime,则写入当前 Unix 时间(秒级);否则直接读取。
  2. 实时更新显示:每秒执行一次 updateTimer(),用当前时间减去 startTime 得到 elapsedSeconds。
  3. 智能格式化与自动归零:在 formatTime() 中判断 elapsedSeconds >= 300(即 ≥5 分钟),一旦触发,立即更新 startTime 并同步写入 localStorage,使下一次计算从 0 开始——这确保了时间显示永远反映「距上一次真实 API 成功调用」的真实间隔。
  4. 解耦数据获取与计时:fetchAndUpdateHashtags() 每 5 分钟调用一次 API;计时器独立运行,二者通过 localStorage 协同,无强依赖。

以下是精简、健壮的前端实现代码(已移除冗余服务端逻辑,聚焦核心时序控制):

<!DOCTYPE html>
<html>
<head>
  <title>Trending Hashtags</title>
  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
  <h1>Trending Hashtags</h1>
  <div id="hashtags-container"></div>
  <div id="timestamp-container">
    <span class="timestamp">Last Refreshed: -</span>
  </div>

  <script>
    // 从 localStorage 初始化 startTime,保证刷新不丢失
    let startTime = parseInt(localStorage.getItem('lastRefreshTime')) || Math.floor(Date.now() / 1000);

    function updateTimer() {
      const now = Math.floor(Date.now() / 1000);
      const elapsed = now - startTime;
      updateTimestamp(elapsed);
    }

    function updateTimestamp(seconds) {
      const el = document.querySelector('#timestamp-container .timestamp');
      if (el) {
        el.textContent = `Last Refreshed: ${formatTime(seconds)} ago`;
      }
    }

    function formatTime(seconds) {
      // ⚠️ 关键:达到 5 分钟即重置计时器,模拟“刚完成刷新”
      if (seconds >= 300) {
        startTime = Math.floor(Date.now() / 1000);
        localStorage.setItem('lastRefreshTime', startTime.toString());
        return '0 sec';
      }

      const mins = Math.floor(seconds / 60);
      const secs = seconds % 60;
      return mins > 0 ? `${mins} min` : `${secs} sec`;
    }

    // 每秒更新时间显示
    setInterval(updateTimer, 1000);

    // 每 5 分钟拉取新数据(触发重置逻辑)
    function fetchAndUpdateHashtags() {
      fetch('/trends')
        .then(res => res.json())
        .then(data => {
          const container = document.getElementById('hashtags-container');
          container.innerHTML = data.data.map((item, i) => 
            `<div class="trend-item">
              <span>${i + 1}.</span>
              <span>${item.hashtag}</span>
              <span class="text-secondary">${formatTweetVolume(item.tweetCount)}</span>
            </div>`
          ).join('');
        })
        .catch(err => console.error('Fetch failed:', err));
    }

    function formatTweetVolume(vol) {
      return vol >= 1000 ? (vol / 1000).toFixed(1) + 'k' : vol;
    }

    // 启动轮询(注意:初始加载也应触发一次)
    fetchAndUpdateHashtags();
    setInterval(fetchAndUpdateHashtags, 300 * 1000); // 5 minutes
  </script>

  <style>
    .trend-item { margin: 8px 0; font-family: -apple-system, sans-serif; }
    .text-secondary { color: #666; font-size: 0.9em; }
  </style>
</body>
</html>

⚠️ 注意事项与最佳实践

  • 服务端无需提供 /start-time 接口:原方案中该接口易引发时钟漂移(客户端和服务端时间不同步)。本方案完全由客户端维护 startTime,更精准、更简单。
  • localStorage 安全性:仅存储时间戳(纯数字),无敏感信息,符合安全规范。
  • 错误容错:若某次 fetch 失败,计时器不会重置,用户仍能感知“数据已过期”,符合真实场景预期。
  • 可扩展性:如需支持小时、天级显示(如 2 hours ago),只需扩展 formatTime() 的判断分支,逻辑清晰易维护。
  • SEO 与首屏体验:时间戳初始值 - 可替换为服务端渲染的静态时间(如 SSR 注入 lastRefreshTime),兼顾首屏速度与准确性。

通过这一设计,你获得的不仅是一个动态时间标签,更是一个具备状态一致性、用户信任感和工程鲁棒性的数据时效指示系统——它默默工作,却让每一次刷新都值得信赖。

立即学习“前端免费学习笔记(深入)”;

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

3063

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

6743

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

7570

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

7518

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

1063

2024.05.22

Golang 入门学习路线:从零基础到上手开发
Golang 入门学习路线:从零基础到上手开发

Golang 入门路线涵盖从零到上手的核心路径:首先打牢基础语法与切片等底层机制;随后攻克 Go 的灵魂——接口设计与 Goroutine 并发模型;接着通过 Gin 框架与 GORM 深入 Web 开发实战;最后在微服务与云原生工具开发中进阶,旨在培养具备高性能并发处理能力的后端工程师。

246

2026.02.24

Golang 疑难杂症解决指南:常见问题排查与优化
Golang 疑难杂症解决指南:常见问题排查与优化

《Golang 疑难杂症解决指南》聚焦开发过程中常见却棘手的问题,从并发模型、内存管理、性能瓶颈到工程化实践逐步拆解。通过真实案例与调试思路,帮助开发者定位问题根因,建立系统化排查方法。不只给出答案,更强调分析路径与工具使用,让你在复杂 Go 项目中具备持续解决问题的能力。

153

2026.02.24

Golang 运行与部署实战:从本地到云端
Golang 运行与部署实战:从本地到云端

《Golang 运行与部署实战》围绕 Go 应用从开发完成到稳定上线的完整流程展开,系统讲解编译构建、环境配置、日志与配置管理、容器化部署以及常见运维问题处理。结合真实项目场景,拆解自动化构建与持续部署思路,帮助开发者建立可靠的发布流程,提升服务稳定性与可维护性。

697

2026.02.24

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn