Unix 时间戳与时区换算的四个常见坑

举报
yd_263929376 发表于 2026/10/22 18:51:49 2026/10/22
【摘要】 Unix 时间戳与时区换算的四个常见坑做时间处理时,最容易被低估的就是时间戳与时区的转换。看起来只是乘除 1000、加减 8 小时,实际每个环节都有坑。最近写了一个转换工具,把踩过的四个问题记下来。 坑一:秒与毫秒只差 1000 倍,但方向容易反后端接口返回的时间戳,多数是 10 位秒级;JavaScript 的 Date.now() 是 13 位毫秒级。两者相差 1000 倍,混用后时间...

Unix 时间戳与时区换算的四个常见坑

做时间处理时,最容易被低估的就是时间戳与时区的转换。看起来只是乘除 1000、加减 8 小时,实际每个环节都有坑。最近写了一个转换工具,把踩过的四个问题记下来。

坑一:秒与毫秒只差 1000 倍,但方向容易反

后端接口返回的时间戳,多数是 10 位秒级;JavaScript 的 Date.now() 是 13 位毫秒级。两者相差 1000 倍,混用后时间会落到 1970 年或几万年以后。

一个实用的判断方式是按位数识别:

const toMs = (raw) => raw.length <= 10 ? Number(raw) * 1000 : Number(raw);

这个规则在 2286 年之前都成立(秒级到那时才突破 10 位),对绝大多数业务足够。

但要注意:不要用"值的大小"判断。有人写 n < 1e11 ? n * 1000 : n,遇到 1970 年代附近的时间戳(比如 1e8)会被误判成毫秒,结果变成 1970-01-02。按位数判断更稳。

坑二:显示的时间对,但它是哪个时区的时间

同一个时间戳,在 UTC 是 10:33,在东八区是 18:33。这两个都对,问题是"你以为你显示的是哪个"。

很多代码这样写:

new Date(ts * 1000).toLocaleString()

输出取决于运行环境的本地时区。开发机在东八区、服务器在 UTC,同一段代码会给出不同结果,测试时看不出问题,上线后才暴露。

正确的做法是显式指定时区:

new Intl.DateTimeFormat("en-CA", {
  timeZone: "Asia/Shanghai",
  year: "numeric", month: "2-digit", day: "2-digit",
  hour: "2-digit", minute: "2-digit", second: "2-digit",
  hour12: false,
}).format(date)

用 en-CA 是因为它的输出顺序是 YYYY-MM-DD,可以直接拼接,不用再调整字段顺序。

坑三:日期转时间戳,不能直接用 new Date(str)

这是最容易出错的一步。假设要把「2026-10-22 18:33 上海时间」转成时间戳:

new Date("2026-10-22 18:33").getTime()  // 危险

这行代码按运行环境本地时区解析。换台机器,结果就变了。而且不同浏览器对非 ISO 格式的处理还不一致。

稳妥的做法是两步修正:先把这组数值当作 UTC 构造一个中间值,再用目标时区格式化它、读回实际显示值,两者之差就是该时区相对 UTC 的真实偏移,最后减掉偏移:

function zonedToEpoch(y, mo, d, h, mi, s, tz) {
  const asUTC = Date.UTC(y, mo - 1, d, h, mi, s);
  const parts = new Intl.DateTimeFormat("en-CA", {
    timeZone: tz, year: "numeric", month: "2-digit", day: "2-digit",
    hour: "2-digit", minute: "2-digit", second: "2-digit", hour12: false,
  }).formatToParts(new Date(asUTC)).reduce((a, p) => (a[p.type] = p.value, a), {});

  const shown = Date.UTC(+parts.year, +parts.month - 1, +parts.day,
                         +parts.hour, +parts.minute, +parts.second);
  return asUTC - (shown - asUTC);
}

这个方法的好处是对夏令时也成立——偏移是从实际格式化结果里读出来的,不是硬编码的固定小时数。伦敦、纽约这些有夏令时的时区不会算错。

坑四:相对时间只该显示一个单位

"3 小时前"比"0 年 0 月 0 天 3 小时 12 分 5 秒前"有用得多。

按年、月、天、小时、分钟、秒六级依次判断,命中第一个就返回,只显示最大单位:

function relative(ts) {
  const diff = ts - Date.now();
  const abs = Math.abs(diff);
  const units = [
    [31536000000, "年"], [2592000000, "个月"], [86400000, "天"],
    [3600000, "小时"], [60000, "分钟"], [1000, "秒"],
  ];
  for (const [size, name] of units) {
    if (abs >= size) {
      const v = Math.floor(abs / size);
      return diff > 0 ? `${v} ${name}后` : `${v} ${name}前\
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。