0

0

datetime 如何处理闰秒(leap second)与时区转换的边界情况

冰川箭仙

冰川箭仙

发布时间:2026-01-23 20:10:03

|

178人浏览过

|

来源于php中文网

原创

飞书多维表格
飞书多维表格

表格形态的AI工作流搭建工具,支持批量化的AI创作与分析任务,接入DeepSeek R1满血版

下载
datetime模块不处理闰秒是设计选择,因其基于理想化公历与均匀秒长模型,每天固定86400秒,且iana时区数据库不包含闰秒数据;实际开发应放弃闰秒精度,优先应对dst切换和时区政治性变更。

datetime 如何处理闰秒(leap second)与时区转换的边界情况

datetime 模块根本不处理闰秒 —— 这不是 bug,是设计选择

为什么 strptime/strftime 和 timedelta 都无视闰秒

Python 的 datetime 模块基于“理想化公历 + 均匀秒长”模型,明确假设每天恒为 86400 秒(24 × 60 × 60),不支持闰秒插入或跳过。IANA 时区数据库(zoneinfo)本身也**不包含闰秒表**;它只记录时区偏移变更(如夏令时切换、政府调整 UTC+8 → UTC+9),而闰秒由 IERS 单独发布,需额外数据源(如 leapseconds.list 文件)。

  • 调用 datetime(2016, 12, 31, 23, 59, 60) 会直接抛出 ValueError: second must be in 0..59 —— datetime 根本不承认第 60 秒存在
  • time.time() 返回的 POSIX 时间戳在闰秒发生时会“重复”一秒(例如 23:59:60 → 23:59:60 再 → 00:00:00),但 datetime.utcfromtimestamp() 会将两个相同时间戳映射为同一个 datetime,造成歧义
  • 所有 timedelta 运算按“每秒严格等于 1 秒”进行,不会因闰秒调整总秒数

时区转换中真正危险的边界:DST 切换与政治性偏移变更

比起不存在的闰秒,datetime 在 DST(夏令时)起止时刻和政府突然改时区的场景下更容易出错 —— 这些才是实际项目里踩坑的高发区:

  • “消失的一小时”:如欧洲 2026 年 3 月 29 日凌晨 01:59:59 后直接跳到 03:00:00。若用 naive datetime 构造 datetime(2026, 3, 29, 2, 30),再用 astimezone() 转换,结果可能意外偏移
  • “重复的一小时”:如美国 2026 年 11 月 1 日凌晨 02:00:00 回拨到 01:00:00,同一本地时间对应两个不同 UTC 时间点。未指定 fold 参数时,datetime 默认取第一个(较早的)时刻
  • 突兀的时区变更:如 2024 年委内瑞拉将时区从 UTC-4:30 改为 UTC-4,或 2011 年 Samoa 跳过 2011-12-30 直接进入 2011-12-31 —— zoneinfo 数据库能反映这些变更,但若代码硬编码偏移量(如 timezone(timedelta(hours=8))),就完全失效

务实建议:什么该做,什么必须放弃

面对闰秒和复杂时区边界,Python 开发者应接受现实约束,聚焦可控制的环节:

  • 放弃闰秒精度金融高频交易、航天测控等真需闰秒的领域,不用 datetime,改用专门库(如 astropy.time)或 C 级别时间 API(clock_gettime(CLOCK_TAI)
  • 强制使用 aware datetime:所有涉及跨时区或持久化的操作,必须用 zoneinfo.ZoneInfo(Python 3.9+)或 pytz 绑定时区,杜绝 datetime.now() 这类 naive 调用
  • DST 切换时显式处理 fold:构造本地时间时,用 datetime(2026, 11, 1, 1, 30, fold=1) 明确指定取回拨后的第二个 01:30
  • 不要解析含闰秒的字符串:像 "2016-12-31T23:59:60Z" 这种格式,strptime 会失败,应提前正则替换掉 :60 或交由外部服务标准化

闰秒在绝大多数 Web/企业应用中只是理论风险,真正要绷紧神经的是 DST 规则变更通知、zoneinfo 数据库更新频率(需定期 pip install --upgrade tzdata),以及永远别相信用户输入的“本地时间”没歧义。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

373

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

436

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

803

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

370

2025.07.23

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1566

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

649

2023.11.24

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号