Python中API请求所用DATETIME格式的编码解码及转换问题咨询

a) 格式差异说明 #

二者的差异不完全是编码与解码的区别，除了URL编码的转义差异外，还包含日期本身的格式差异：

• 你给出的请求参数示例%5Bgt%5D=2021-08-03T13%3A15%3A30Z做URL解码后得到[gt]=2021-08-03T13:15:30Z，其中%5B、%5D、%3A是URL编码转义字符，分别对应[、]、:；该参数内的日期是UTC时区的ISO8601格式，带Z后缀，精确到秒。
• API响应返回的日期2021-08-03T09:17:42.087726-04:00是带UTC-4时区偏移的ISO8601格式，精确到微秒。

URL编码仅负责转义非URL安全的特殊字符，不会修改日期的时区、精度和后缀属性。

b) 转换实现代码（Python） #

你可以通过Python标准库datetime和urllib.parse完成双向转换，示例如下：

from datetime import datetime, timezone
import urllib.parse

# --------------------------
# 响应日期转请求参数（正向转换）
# --------------------------
response_date_str = "2021-08-03T09:17:42.087726-04:00"
# 1. 解析响应返回的带时区日期
dt = datetime.fromisoformat(response_date_str)
# 2. 转换为UTC时区，移除微秒精度
dt_utc = dt.astimezone(timezone.utc).replace(microsecond=0)
# 3. 格式化为请求要求的带Z后缀的UTC时间格式
dt_req_str = dt_utc.isoformat().replace("+00:00", "Z")
# 4. 拼接参数并做URL编码，得到符合要求的请求参数
params = {"[gt]": dt_req_str}
encoded_params = urllib.parse.urlencode(params)
print(encoded_params) # 输出：%5Bgt%5D=2021-08-03T13%3A17%3A42Z

# --------------------------
# 请求参数转可识别日期（反向转换）
# --------------------------
encoded_param = "%5Bgt%5D=2021-08-03T13%3A15%3A30Z"
# 1. URL解码得到原始参数键值对
decoded_query = urllib.parse.parse_qs(encoded_param)
dt_str = decoded_query["[gt]"][0]
# 2. 解析为UTC时间的datetime对象
dt = datetime.fromisoformat(dt_str.replace("Z", "+00:00"))
# 可按需转换为对应时区的格式
dt_utc_minus4 = dt.astimezone(timezone(offset=-datetime.timedelta(hours=4)))
print(dt_utc_minus4.isoformat(timespec="microseconds")) # 输出：2021-08-03T09:15:30-04:00

注：以上代码兼容Python 3.7及以上版本。

c) 通用实践确认 #

该处理方式是API请求中的通用实践：

• URL编码是HTTP协议的标准要求，所有包含非URL安全字符（如[、]、空格、特殊符号等）的查询参数都需要做URL编码，避免服务端解析异常。
• 响应返回带时区信息的高精度时间、请求要求传入标准UTC时区的时间，是REST API的常见设计，既可以避免多客户端时区不一致导致的逻辑错误，也可以降低服务端参数解析的复杂度。

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