Swagger接口DateTime参数日与月被切换问题求助

核心原因 #

问题出在日期解析的格式约定冲突：

• Swagger定义的string($date-time)标准遵循ISO 8601规范（比如yyyy-MM-ddTHH:mm:ssZ），但当你传入10/12/2024这种斜杠分隔的非标准格式时，后端的日期解析器会按系统默认区域设置来解析。
• 多数系统默认区域（比如en-US）采用月/日/年的解析规则，所以10/12/2024会被识别为12月10日；而你预期的是日/月/年，两者规则不匹配导致反转。
• 2024/12/10能正常解析是因为年份在前的格式没有歧义，解析器能直接识别顺序。

解决方法 #

• 显式指定日期格式：在后端接口的参数配置中，明确指定支持日/月/年的格式。比如.NET中给DateTime参数添加[DisplayFormat(DataFormatString = "{0:dd/MM/yyyy}")]特性；Java中自定义DateTimeFormatter.ofPattern("dd/MM/yyyy")来解析参数。
• 统一使用标准ISO格式：在Swagger文档中明确要求客户端使用ISO 8601标准日期格式（如2024-12-10或2024-12-10T12:00:00Z），这是string($date-time)的规范用法，彻底避免格式歧义。
• 调整解析器区域设置：如果必须支持日/月/年格式，可以修改后端解析器的区域为默认采用该格式的类型（比如en-GB），但注意这会影响所有日期解析逻辑，需全局评估。

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