hooks icon indicating copy to clipboard operation
hooks copied to clipboard

feat: useCountdown 新增 currentServerTime 配置

Open rambuild opened this issue 4 months ago • 1 comments

🤔 这个变动的性质是?

  • [x] 新特性提交
  • [ ] 日常 bug 修复
  • [ ] 站点、文档改进
  • [ ] 演示代码改进
  • [x] TypeScript 定义更新
  • [ ] 包体积优化
  • [ ] 性能优化
  • [ ] 功能增强
  • [ ] 国际化改进
  • [ ] 重构
  • [ ] 代码风格优化
  • [ ] 测试用例
  • [ ] 分支合并
  • [ ] 其他改动(是关于什么的改动?)

💡 需求背景和解决方案

  • 因为用户可能修改本地系统时间,直接用 targetDate(基于 Date.now())计算会导致倒计时不准确。
  • 目标:倒计时应与“权威时间源”(服务端)对齐,具备抗本地时间篡改能力,并可控误差。

📝 更新日志

  • useCountdown 新增了 currentServerTime 配置,当未配置此字段时,会使用本地时间进行倒计时,与之前版本一样,用户升级后不会影响已有逻辑,保持向前兼容原则。
语言 更新描述
🇺🇸 英文 Added currentServerTime configuration instructions and example code
🇨🇳 中文 新增了currentServerTime的配置说明和实例代码

☑️ 请求合并前的自查清单

⚠️ 请自检并全部勾选全部选项。⚠️

  • [x] 文档已补充或无须补充
  • [x] 代码演示已提供或无须提供
  • [x] TypeScript 定义已补充或无须补充
  • [x] Changelog 已提供或无须提供

rambuild avatar Aug 28 '25 09:08 rambuild

CLA assistant check
All committers have signed the CLA.

CLAassistant avatar Aug 28 '25 09:08 CLAassistant