Python 的 datetime 模块原生仅支持 1–9999 年范围，超出该范围（如 year=10000）会触发 ValueError；这是由设计规范和历史兼容性决定的硬性限制，而非公历本身不支持。
python 的 `datetime` 模块原生仅支持 1–9999 年范围，超出该范围（如 year=10000）会触发 `valueerror`；这是由设计规范和历史兼容性决定的硬性限制，而非公历本身不支持。
Python 的 datetime 类（包括 date、datetime 和 time）严格遵循 ISO 8601 标准的常见实现惯例，并在底层依赖 C 标准库与固定字长整数表示年份。根据 官方文档，datetime.MAXYEAR 明确定义为 9999，而 datetime.MINYEAR 为 1 —— 这意味着 任何尝试构造 year=10000 或更大的 datetime 对象都会立即抛出 ValueError: year 10000 is out of range。
from datetime import datetime
# ❌ 这会失败
try:
dt = datetime(10000, 1, 1)
except ValueError as e:
print(e) # 输出：year 10000 is out of range
这一限制并非源于格里高利历（公历）的数学或天文失效——事实上，公历在万年尺度上仍具良好近似性（尽管需未来闰秒/闰年规则调整）。真正原因在于：
- 向后兼容性：早期 C 库（如 struct tm）普遍使用 16 位有符号整数存储年份（tm_year 从 1900 起算），虽现代 Python 已用 32 位，但为保持 API 稳定性和序列化兼容性（如 pickle、strftime 格式 %Y 强制 4 位输出），上限被锁定为 9999；
- 格式化约束：strftime('%Y') 等方法默认输出 4 位数字，无法无损表达 5 位年份；
- 标准互操作性：ISO 8601:2004 允许扩展年份格式（如 +10000），但 Python 的 datetime 未实现该扩展语法。
✅ 若业务场景确实需要万年尺度时间建模（如地质年代、长期天文预测、科幻系统），推荐以下替代方案：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
-
自定义类 + timedelta 基准偏移
以 datetime(1, 1, 1) 为纪元起点，用 timedelta 表示距其总天数（支持超大整数）：from datetime import datetime, timedelta # 纪元基准（最小合法 datetime） EPOCH = datetime(1, 1, 1) # 计算公元 10000 年 1 月 1 日距纪元的天数（粗略估算，忽略历法变更） days_to_10k = (10000 - 1) * 365 + (10000 // 4) - (10000 // 100) + (10000 // 400) dt_10k = EPOCH + timedelta(days=days_to_10k) # ⚠️ 注意：此法不保证精确到日（因未处理儒略→格里高利历改革等），仅作示意
-
使用第三方库
- astropy.time：专为天文计算设计，支持 Time('+10000-01-01', format='iso', scale='utc')，内部使用儒略日（JD）表示，天然支持 ±10⁹ 年范围；
- cftime：气候建模常用，支持 DatetimeNoLeap、Datetime360Day 等自定义历法及超长年份。
? 总结：Python datetime 的 9999 年上限是工程权衡结果，非历法缺陷。如需万年精度，请明确需求场景——若仅为逻辑标记或相对计算，timedelta + 基准点足够；若需高精度绝对时刻（含闰秒、历法规则），务必选用 astropy.time 等专业库。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
