Python将9999/12/31本地化至Asia/Taipei时区遇问题的解决方案咨询

我用Python将时间字符串本地化至Asia/Taipei时区后存入MongoDB，遇到两个问题：

• 用tz.localize()处理9999/12/31时抛出OverflowError: date value out of range，但处理2024/01/01这类正常时间完全没问题。
• 改用replace(tzinfo=tz)后，得到的时区偏移是UTC+08:06而非正确的+08:00，目前临时用加6分钟的方法修正，但不确定是否妥当，求正确的时区设置方案。

相关代码如下：

import pytz
from datetime import datetime, date, timedelta
tz = pytz.timezone('Asia/Taipei')
date_string = '9999/12/31'

# method 1
# date_localized = datetime.strptime(date_string, '%Y/%m/%d')
# date_localized = tz.localize(date_localized)
# OverflowError: date value out of range

# method 2
date_localized = datetime.strptime(date_string, '%Y/%m/%d').replace(tzinfo=tz)
# 存入MongoDB后显示为9999-12-30T15:54:00.000+00:00

# method 3
date_localized = datetime.strptime(date_string, '%Y/%m/%d').replace(tzinfo=tz)
date_localized = date_localized + timedelta(minutes=6)
# 存入MongoDB后显示为9999-12-30T16:00:00.000+00:00

1. 为什么localize()处理9999/12/31报错？ #

pytz的localize()会计算时区的历史偏移规则（比如台北时区早年确实采用过UTC+08:06的偏移），但9999年超出了pytz内置的时区规则数据范围，导致计算时触发溢出错误。

2. 正确设置时区的两种方法 #

方法A：针对远未来日期直接构造正确偏移 #

因为台北时区从1945年之后就固定为UTC+08:00，远未来的9999年不会再变动时区偏移，可直接构造UTC+8的时间并转换时区：

from datetime import datetime, timedelta
import pytz

tz = pytz.timezone('Asia/Taipei')
date_string = '9999/12/31'

# 解析为 naive datetime
dt_naive = datetime.strptime(date_string, '%Y/%m/%d')
# 转换为UTC时间再转台北时区
dt_utc = dt_naive - timedelta(hours=8)
dt_taipei = pytz.utc.localize(dt_utc).astimezone(tz)

方法B：用Python内置的zoneinfo替代pytz（Python 3.9+） #

Python 3.9及以上内置的zoneinfo模块对远未来日期的支持更完善，不会出现历史偏移错误，直接替换时区即可得到正确结果：

from datetime import datetime
from zoneinfo import ZoneInfo

tz = ZoneInfo('Asia/Taipei')
date_string = '9999/12/31'

dt_naive = datetime.strptime(date_string, '%Y/%m/%d')
dt_localized = dt_naive.replace(tzinfo=tz)
# 此时dt_localized的偏移为正确的UTC+08:00，存入MongoDB后会显示为9999-12-30T16:00:00.000+00:00

3. 为什么临时加6分钟的方案不妥？ #

这种硬编码的修正只适用于当前远未来场景，如果遇到1945年之前的台北时间（当时偏移是UTC+08:06），加6分钟反而会导致时间错误。正确做法是依赖时区库的规则自动处理偏移，而非手动调整。

内容的提问来源于stack exchange，提问作者ann