时间戳转本地时间需显式指定时区，推荐用zoneinfo.ZoneInfo('Asia/Shanghai')获取带时区的aware datetime，避免依赖系统默认时区导致跨环境结果不一致。
时间戳转本地时间默认是 UTC，不是你电脑时区——这是最常踩的坑。
datetime.fromtimestamp() 为什么返回的时间不对？
因为 datetime.fromtimestamp() 默认按系统本地时区解释时间戳，但如果你在代码里显式传了 tz 参数（比如 timezone.utc），它就变成带时区对象，后续格式化可能出错；更常见的是没传 tz，却误以为它和 datetime.now() 一样“自动匹配当前时区”——其实它依赖 time.tzname 和系统设置，Docker 容器或 CI 环境里经常是 UTC。
- 正确做法：明确指定时区，用
datetime.fromtimestamp(ts, tz=zone) - 获取本地时区推荐用
zoneinfo.ZoneInfo('Asia/Shanghai')（Python 3.9+），不要用time.timezone手动算偏移 - 如果必须兼容旧版本，可用
dateutil.tz.tzlocal()，但要额外装python-dateutil
时间戳转本地时间（秒级，带时区）
秒级时间戳就是整数或浮点数，比如 1717023600。关键是要让结果是 aware datetime（带时区），否则跨时区操作会出错。
from datetime import datetime
from zoneinfo import ZoneInfo
<p>ts = 1717023600</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill7154" title="python-pro"><img
src="https://img.php.cn/upload/skill/000/000/081/179134208595348.jpg" alt="python-pro" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill7154" title="python-pro">python-pro</a>
<p>高级 Python 特性、异步编程、性能调优、静态类型、内存管理、Python 内部机制及生态库方面的专家。</p>
</div>
<a href="/xiazai/skill7154" title="python-pro" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><h1>转为上海时区的本地时间（aware）</h1><p>dt_local = datetime.fromtimestamp(ts, tz=ZoneInfo('Asia/Shanghai'))
print(dt_local) # 2024-05-30 15:00:00+08:00</p><h1>如果只要字符串（不带时区信息），再 .strftime()，但别用 .replace(tzinfo=None)</h1><p>print(dt_local.strftime('%Y-%m-%d %H:%M:%S')) # '2024-05-30 15:00:00'
- 别用
datetime.utcfromtimestamp()再手动加 8 小时——夏令时、历史时区变更会让这个逻辑崩掉 -
ZoneInfo支持 IANA 时区名，比固定偏移更可靠（如'Asia/Shanghai'自动处理中国不实行夏令时的事实） - Windows 上首次使用
ZoneInfo可能报错，需先运行pip install tzdata
本地时间（字符串）转时间戳（秒级）
反过来时，必须确保输入时间是 aware 的，否则 .timestamp() 会按系统本地时区解释——这在服务器上极不可靠。
from datetime import datetime
from zoneinfo import ZoneInfo
<p>s = '2024-05-30 15:00:00'</p><h1>错误：没时区，.timestamp() 行为不确定</h1><h1>dt_naive = datetime.strptime(s, '%Y-%m-%d %H:%M:%S')</h1><h1>正确：先绑定时区，再转时间戳</h1><p>dt_aware = datetime.strptime(s, '%Y-%m-%d %H:%M:%S').replace(tzinfo=ZoneInfo('Asia/Shanghai'))
ts = int(dt_aware.timestamp()) # 强制取整到秒
print(ts) # 1717023600
-
strptime返回 naive datetime，必须用.replace(tzinfo=...)或.astimezone()转成 aware - 用
int(...)截断小数部分，避免毫秒级时间戳被转成 float 秒（timestamp()返回 float） - 如果原始字符串已含时区信息（如
'2024-05-30 15:00:00+08:00'），可用datetime.fromisoformat()直接解析
真正麻烦的不是转换本身，而是「默认行为」和「环境差异」——同一段代码在 macOS、Linux 容器、Windows 开发机上可能给出不同结果。强制用 ZoneInfo 绑定时区，是最小代价的稳定方案。
