如何使用Flutter的json_serializable包将DateTime转换为MongoDB ISODate

MongoDB的ISODate本质是UTC标准的BSON日期类型，绝大多数官方驱动都支持原生时间类型的自动映射，不需要手动做格式转换，以下是不同场景的实现方式：

1. 驱动原生映射（推荐方案） #

直接传入对应编程语言的原生时间类型，驱动会自动转为ISODate格式存储，读取时也会自动转回原生时间类型：

• JavaScript/Node.js（原生驱动/Mongoose）
  直接传入JS原生Date对象即可：

  const insertData = { createTime: new Date() };
  await collection.insertOne(insertData);
  

• Python（PyMongo）
  传入Python原生datetime类型，推荐优先使用UTC时间避免时区偏移：

  from datetime import datetime
  collection.insert_one({"create_time": datetime.utcnow()})
  

• Java（原生驱动/Spring Data MongoDB）
  直接传入java.util.Date、JDK8+Instant/LocalDateTime类型即可，框架会自动完成类型映射。
• C#（MongoDB C# Driver）
  传入DateTime类型时建议将Kind属性设为Utc，驱动会自动转换为ISODate：

  var document = new BsonDocument { { "createTime", DateTime.UtcNow } };
  collection.InsertOne(document);
  

2. 手动构造场景 #

如果需要手动生成ISODate，只要遵循YYYY-MM-DDTHH:mm:ss.sssZ的UTC时间格式即可，Mongo Shell中也可以直接用ISODate()方法构造：

• Shell操作示例：

  db.test.insertOne({ createTime: ISODate("2024-05-01T08:00:00.000Z") })
  

• 注意事项：格式末尾的Z代表UTC时区，如果你的时间带有时区偏移，需要先转为UTC时间再存储，避免后续查询出现时区偏差

常见问题排查 #

• 如果存储后发现是字符串类型而非ISODate，检查是否错误将DateTime转为普通字符串后再传入驱动，直接传原生时间类型即可解决。
• 跨时区业务建议统一使用UTC时间存储，业务层根据用户所在时区做展示转换，避免不同时区用户查询出现数据错误。

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