agilelabs-fx-docs main tasks/handle-time.md

处理时间与多时区

本页面向需要在 API、数据库、前端展示和用户时区之间保持一致的人。它重点解决“时间到底按什么语义传、存、转、显”。

我现在要解决什么

  • 存储层如何保持 UTC 语义。
  • API 对外怎么统一成毫秒 Unix timestamp。
  • 用户时区从哪里来,什么时候挂到 WorkContext
  • 展示时间、输入时间和并发版本字段怎么区分。

先看哪几页

  1. 框架规范 / 时间与时区规范
  2. 时间与多时区
  3. WorkContext

最短落地路径

  • 先统一“存储语义、传输语义、输入语义、展示语义”。
  • 再决定是否要建立项目级用户时区 resolver。

真实项目怎么做

  • gmandarin-backend:项目级 AutoMapper 时间解析器体系。
  • woscmDateTimeOffset.UtcNow 审计时间 + ts 并发版本双轨设计。

相关主题