Unix 时间戳与时区换算的四个常见坑
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}前\
- 点赞
- 收藏
- 关注作者
评论(0)