Codex项目通过后端配置Jackson为ISO 8601格式、前端用date-fns安全解析、约定时间字段命名及Swagger标注，统一日期时间处理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Codex项目中统一前后端日期时间格式，避免因时区、字符串解析或序列化方式不同导致的时间显示错乱、API交互失败或数据库写入异常。
后端定义全局日期时间序列化规则
在Spring Boot项目中，修改application.yml配置文件，强制Jackson使用ISO 8601标准格式输出所有LocalDateTime和ZonedDateTime字段：
添加以下配置项：
spring.jackson.date-format=yyyy-MM-dd'T'HH:mm:ss.SSSXXXspring.jackson.time-zone=GMT+8spring.jackson.serialization.write-dates-as-timestamps=false
这三行配置确保后端返回的JSON中时间字段为带时区的ISO字符串（如"2024-05-20T14:30:45.123+08:00"），而非毫秒时间戳。若遗漏write-dates-as-timestamps=false，前端收到的是数字而非字符串，后续解析必然出错。
前端统一解析并格式化时间字符串
在Vue或React项目中，不依赖new Date(str)直接解析后端返回的ISO字符串——该方式在Safari和部分Android WebView中对带+08:00的格式兼容性差，易返回Invalid Date。
方法一：使用date-fns库安全解析
安装：npm install date-fns
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
解析示例：parseISO('2024-05-20T14:30:45.123+08:00') → 返回标准Date对象，兼容所有浏览器。
方法二：手动截断时区后用Date.UTC构造（无依赖）
对形如"2024-05-20T14:30:45.123+08:00"的字符串，先提取年月日时分秒毫秒，再根据+08:00换算为UTC毫秒数，调用new Date(utcTimestamp)生成本地Date实例。此方式绕过浏览器原生解析缺陷，但需自行处理时区偏移计算逻辑。
【关键前提】前端所有时间展示必须基于解析后的Date对象，禁止直接渲染原始字符串——否则用户看到的是带T和时区的原始值，不符合中文界面习惯。
前后端约定时间字段命名与类型
第一步：后端DTO中所有时间字段命名以Time或At结尾，例如createdAt、updatedAt、expireTime，禁止使用date、time等模糊名称。
第二步：Swagger接口文档中为每个时间字段添加@Schema(type = "string", format = "date-time")注解，明确标注其为ISO 8601格式字符串。
第三步：前端Axios响应拦截器中，自动识别字段名含Time或At且值为字符串的属性，尝试用parseISO转换为Date对象，并挂载到_parsed副本上供业务组件使用。
这一步建立字段语义与行为的强关联，避免开发人员对“看起来像时间的字符串”做随意new Date()操作。
