Unix 时间戳转换指南：原理与使用场景

Unix 时间戳是计算机世界中最通用的时间表示方式。从服务器日志到数据库记录，从 API 响应到 JWT 令牌，时间戳无处不在。本文将帮你彻底理解 Unix 时间戳的原理、转换方法和常见问题。

什么是 Unix 时间戳？

Unix 时间戳（Unix Timestamp），也称为 Epoch 时间或 POSIX 时间，是从 1970 年 1 月 1 日 00:00:00 UTC（称为 Unix 纪元）到某一时刻所经过的秒数。

0           = 1970-01-01 00:00:00 UTC  (Unix 纪元)
1000000000  = 2001-09-09 01:46:40 UTC  (十位数时代开始)
1700000000  = 2023-11-14 22:13:20 UTC
1741766400  = 2025-03-12 08:00:00 UTC
2147483647  = 2038-01-19 03:14:07 UTC  (32 位上限)

秒级 vs 毫秒级时间戳

不同系统使用不同精度的时间戳：

// JavaScript 使用毫秒级时间戳
Date.now();                    // 1741766400000 (毫秒)
Math.floor(Date.now() / 1000); // 1741766400    (秒)

// Python 使用秒级（浮点数）
import time
time.time()           # 1741766400.123456
int(time.time())      # 1741766400

各语言时间戳操作

JavaScript

// 获取当前时间戳
const now = Date.now();                // 毫秒
const nowSec = Math.floor(now / 1000); // 秒

// 时间戳 → 日期对象
const date = new Date(1741766400 * 1000);
console.log(date.toISOString());
// "2025-03-12T08:00:00.000Z"

// 格式化为本地时间
console.log(date.toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }));
// "2025/3/12 16:00:00"

// 日期字符串 → 时间戳
const ts = Math.floor(new Date('2025-03-12T16:00:00+08:00').getTime() / 1000);
// 1741766400

Python

from datetime import datetime, timezone

# 获取当前时间戳
import time
now = int(time.time())

# 时间戳 → datetime 对象 (UTC)
dt = datetime.fromtimestamp(1741766400, tz=timezone.utc)
print(dt.isoformat())  # "2025-03-12T08:00:00+00:00"

# datetime → 时间戳
ts = int(dt.timestamp())  # 1741766400

# 指定时区
from zoneinfo import ZoneInfo
dt_cn = dt.astimezone(ZoneInfo("Asia/Shanghai"))
print(dt_cn.strftime("%Y-%m-%d %H:%M:%S %Z"))
# "2025-03-12 16:00:00 CST"

命令行

# macOS: 时间戳 → 日期
date -r 1741766400
# Wed Mar 12 16:00:00 CST 2025

# Linux: 时间戳 → 日期
date -d @1741766400
# Wed Mar 12 16:00:00 CST 2025

# 获取当前时间戳
date +%s
# 1741766400

时区处理

Unix 时间戳本身没有时区概念，它始终表示 UTC 时间。同一时刻在全球任何地方的 Unix 时间戳都是相同的。

// 不推荐：时区不明确
new Date("2025-03-12")           // 可能是 UTC，也可能是本地时间
new Date("2025-03-12 16:00:00")  // 通常被解释为本地时间

// 推荐：明确指定时区
new Date("2025-03-12T16:00:00+08:00")  // 北京时间
new Date("2025-03-12T08:00:00Z")       // UTC 时间

Y2038 问题

32 位有符号整数能表示的最大值是 2,147,483,647，对应 2038 年 1 月 19 日 03:14:07 UTC。超过这个时间点，32 位系统的时间戳将溢出为负数。

这个问题类似于千年虫（Y2K）问题。好消息是：

• 现代 64 位系统不受影响（可表示到公元 2920 亿年后）
• JavaScript 使用浮点数存储，不受 32 位限制
• 多数现代数据库已使用 64 位时间戳

时间戳的常见应用

• API 缓存控制：Cache-Control: max-age=3600
• JWT 过期时间："exp": 1741852800（详见 JWT 指南）
• 日志记录：统一使用 UTC 时间戳，避免时区混乱
• 数据库索引：整数时间戳比日期字符串查询更快
• 文件版本控制：style.css?v=1741766400

延伸阅读

• JWT 完全指南 — JWT 中 exp 和 iat 字段使用 Unix 时间戳
• JSON 格式化指南 — API 响应中的时间戳格式
• YAML vs JSON — 配置文件中的日期时间表示