json.dumps() 默认不支持 datetime，需用 default 参数自定义序列化函数，推荐转为 iso 8601 字符串；反序列化需额外用 object_hook 或结构化方案还原。
json.dumps() 直接序列化 datetime 会报错
Python 的 json.dumps() 默认不支持 datetime 对象，直接传入会抛出 TypeError: Object of type datetime is not JSON serializable。这不是 bug，而是标准库的明确限制——JSON 规范本身没有日期类型，必须由使用者决定如何编码（字符串格式？时间戳？时区怎么处理？）。
常见错误写法：
import json
from datetime import datetime
data = {"time": datetime.now()}
json.dumps(data) # ❌ 报错
解决思路是提供自定义的 default 参数函数，让 json.dumps() 在遇到无法序列化的对象时“问它一句”该怎么转。
用 default 参数把 datetime 转成 ISO 格式字符串
最常用、最兼容的做法是转成 ISO 8601 字符串（如 "2024-05-22T14:30:45.123456"），它可读性强，且被大多数语言和数据库原生识别。
实操建议：
- 检查对象是否为
datetime、date或time，再调用.isoformat() - 注意
datetime和date的isoformat()行为不同：前者带时间，后者只有日期 - 若需保留微秒但去掉末尾零（如
123000 → 123），得手动截断或用strftime()
示例：
import json
from datetime import datetime, date
<p>def json_serializer(obj):
if isinstance(obj, (datetime, date)):
return obj.isoformat()
raise TypeError(f"Object of type {type(obj).<strong>name</strong>} is not JSON serializable")</p><p>data = {"created": datetime(2024, 5, 22, 14, 30, 45, 123456), "due": date(2024, 12, 31)}
json.dumps(data, default=json_serializer)</p><h1>→ '{"created": "2024-05-22T14:30:45.123456", "due": "2024-12-31"}'</h1><p></p>
需要时间戳（int/float）时，default 函数要区分时区
如果后端或协议要求 Unix 时间戳（秒或毫秒级数字），不能直接用 datetime.timestamp() —— 它对无时区的 datetime（naive）会按本地时区解释，极易出错。
实操建议：
- 优先使用带时区的
datetime（aware），例如datetime.now(tz=timezone.utc) - naive 对象应先明确赋予时区（如
obj.replace(tzinfo=timezone.utc)），再调用.timestamp() - 返回整数秒还是浮点秒？取决于下游要求；毫秒需乘以 1000 并转
int
示例（安全转 UTC 时间戳）：
from datetime import datetime, timezone <p>def json_serializer(obj): if isinstance(obj, datetime): if obj.tzinfo is None: obj = obj.replace(tzinfo=timezone.utc) return int(obj.timestamp()) # 秒级整数时间戳 raise TypeError(...) </p>
别忽略反序列化：json.loads() 不会自动变回 datetime
json.loads() 只负责解析 JSON 字符串，不管内容是不是日期。即使你存的是 "2024-05-22T14:30:45"，加载出来仍是 str，不是 datetime。
这意味着：序列化和反序列化是两个独立步骤，必须配对设计。常见疏漏是只解决了 dumps，却让下游代码自己去 strptime，既重复又容易格式不一致。
如果你控制整个数据流，建议在反序列化时用 object_hook 统一转换：
def datetime_hook(d):
for k, v in d.items():
if isinstance(v, str) and 'T' in v and ':' in v:
try:
d[k] = datetime.fromisoformat(v)
except ValueError:
pass
return d
<p>json.loads('{"time": "2024-05-22T14:30:45"}', object_hook=datetime_hook)
</p>
但注意：这种启发式解析有风险，最好约定好字段名（如所有以 _at 结尾的值都是 datetime），或用更严格的结构化方案（如 Pydantic 模型）。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
