Python 中 JSON 模块无法序列化日期对象的原因及解决方案-Python教程-PHP中文网

Python 中 JSON 模块无法序列化日期对象的原因及解决方案

霞舞

发布： 2025-09-07 10:28:27

原创

486人浏览过

python 中 json 模块无法序列化日期对象的原因及解决方案

JSON 模块是 Python 中用于处理 JSON 数据的标准库，但它默认情况下无法直接序列化 datetime 和 date 对象。这是因为 JSON 规范本身并不支持这些 Python 特有的数据类型。为了解决这个问题，我们需要将日期和时间对象转换为 JSON 可以识别的格式，通常是字符串。

问题分析

Python 的 json.dumps() 方法用于将 Python 对象序列化为 JSON 字符串。然而，当遇到 datetime 或 date 对象时，由于 JSON 标准不支持这些类型，json.dumps() 会抛出 TypeError: Object of type date is not JSON serializable 异常。

这是因为 JSON 是一种通用的数据交换格式，旨在跨多种编程语言和平台使用。为了保持兼容性，它只支持少数几种基本数据类型，如字符串、数字、布尔值、数组和对象。

解决方案

以下是一些解决此问题的常用方法：

立即学习“Python免费学习笔记（深入）”；

1. 使用 isoformat() 方法

datetime 和 date 对象都提供了 isoformat() 方法，可以将它们转换为 ISO 8601 格式的字符串，这种格式易于解析和跨平台使用。

import json
from datetime import datetime, date

data = {
    'name': 'Example',
    'date': date(2023, 10, 27),
    'datetime': datetime(2023, 10, 27, 10, 30, 0)
}

# 使用 isoformat() 将日期和时间转换为字符串
data['date'] = data['date'].isoformat()
data['datetime'] = data['datetime'].isoformat()

json_data = json.dumps(data)
print(json_data)

登录后复制

输出：

{"name": "Example", "date": "2023-10-27", "datetime": "2023-10-27T10:30:00"}

登录后复制

2. 自定义序列化函数

可以定义一个自定义的序列化函数，作为 json.dumps() 的 default 参数传入。该函数负责将 datetime 和 date 对象转换为字符串。

GPTKit

一个AI文本生成检测工具

108

查看详情

import json
from datetime import datetime, date

def custom_serializer(obj):
    if isinstance(obj, (datetime, date)):
        return obj.isoformat()
    raise TypeError("Type not serializable")

data = {
    'name': 'Example',
    'date': date(2023, 10, 27),
    'datetime': datetime(2023, 10, 27, 10, 30, 0)
}

json_data = json.dumps(data, default=custom_serializer)
print(json_data)

登录后复制

输出：

{"name": "Example", "date": "2023-10-27", "datetime": "2023-10-27T10:30:00"}

登录后复制

3. 使用 strftime() 方法格式化日期和时间

strftime() 方法允许你根据指定的格式字符串将 datetime 对象格式化为字符串。

import json
from datetime import datetime

data = {
    'name': 'Example',
    'datetime': datetime(2023, 10, 27, 10, 30, 0)
}

data['datetime'] = data['datetime'].strftime('%Y-%m-%d %H:%M:%S')

json_data = json.dumps(data)
print(json_data)

登录后复制

输出：

{"name": "Example", "datetime": "2023-10-27 10:30:00"}

登录后复制

4. 使用第三方库

一些第三方库，如 marshmallow，提供了更高级的序列化和反序列化功能，可以方便地处理日期和时间对象。

from marshmallow import Schema, fields
import datetime
import json

class EventSchema(Schema):
    name = fields.Str()
    event_date = fields.Date()
    event_time = fields.DateTime()

event_data = {
    'name': 'Sample Event',
    'event_date': datetime.date(2024, 1, 15),
    'event_time': datetime.datetime(2024, 1, 15, 14, 30, 0)
}

schema = EventSchema()
result = schema.dump(event_data)

print(json.dumps(result))

登录后复制

输出:

{"name": "Sample Event", "event_date": "2024-01-15", "event_time": "2024-01-15T14:30:00"}

登录后复制

注意事项

选择哪种方法取决于你的具体需求。如果需要标准的 ISO 8601 格式，isoformat() 是一个不错的选择。如果需要自定义格式，可以使用 strftime()。
在反序列化 JSON 数据时，需要将字符串转换回 datetime 或 date 对象。可以使用 datetime.strptime() 或 date.fromisoformat() 方法。
确保在序列化和反序列化过程中使用一致的格式，以避免出现错误。

总结

由于 JSON 规范不支持 datetime 和 date 对象，我们需要在序列化之前将它们转换为字符串。本文介绍了多种解决方案，包括使用 isoformat() 方法、自定义序列化函数、strftime() 方法以及第三方库。选择合适的方法可以帮助你轻松地处理包含日期和时间的数据，并将其转换为 JSON 格式。

以上就是Python 中 JSON 模块无法序列化日期对象的原因及解决方案的详细内容，更多请关注php中文网其它相关文章！