AWS SDK for .NET 中 DynamoDBContext 对 DateOnly 和 TimeOnly 的支持

在最新发布的 AWSSDK.DynamoDBv2 4.0.0-preview.10 版本中，AWS .NET SDK 团队为 DynamoDBContext 添加了对 .NET 6+ 新增的 DateOnly 和 TimeOnly 类型的原生支持。这一改进解决了开发者在使用 DynamoDB 存储纯日期或纯时间数据时的痛点。

背景与需求

在数据处理场景中，我们经常遇到只需要存储日期（如生日、事件日期）或时间（如营业时间、会议时间）而不需要完整时间戳的情况。在 .NET 6 之前，开发者只能使用 DateTime 类型，这会导致存储冗余信息（时间部分为默认值）或引入额外的转换逻辑。

.NET 6 引入了两个专门处理这类场景的值类型：

• DateOnly：仅表示日期（年、月、日）
• TimeOnly：仅表示时间（时、分、秒、毫秒）

实现方案

AWS SDK 团队通过添加四个新的转换器来实现这一功能：

• DateOnlyConverterV1
• TimeOnlyConverterV1
• DateOnlyConverterV2
• TimeOnlyConverterV2

这些转换器采用了与现有 DateTime 转换器不同的字符串格式：

• DateOnly 使用 "yyyy-MM-dd" 格式
• TimeOnly 使用 "HH:mm:ss.fff" 格式

这种设计保持了与现有系统的兼容性。即使 .NET Framework 或其他不支持 DateOnly/TimeOnly 的平台访问这些数据，也能通过 DateTime 类型解析这些格式。

技术细节

实现上主要涉及三个方面的修改：

1. DynamoDBEntryConversion 中新增转换器注册
2. SchemaV1 和 SchemaV2 对新增类型的支持
3. 条件编译确保只在支持的目标框架中启用

值得注意的是，由于 DateOnly 和 TimeOnly 是 .NET 6+ 引入的类型，这些功能不会在 .NET Standard 版本中提供。

开发者价值

这一改进为开发者带来了以下好处：

1. 更精确的数据建模能力，可以准确表达业务领域中的纯日期/时间概念
2. 减少不必要的类型转换代码
3. 保持向后兼容性，现有系统仍能读取新格式的数据
4. 与 .NET 生态的新特性保持同步

总结

AWS SDK for .NET 团队持续关注开发者需求，通过添加对 DateOnly 和 TimeOnly 的支持，进一步提升了 DynamoDB 在 .NET 应用中的数据建模能力。这一改进体现了 AWS 对 .NET 生态系统的重视，也为开发者处理日期时间数据提供了更专业的工具。

对于正在使用或计划使用 DynamoDB 的 .NET 6+ 项目，建议升级到最新预览版本来体验这一功能。