jvx 提供细粒度的时区控制能力，既支持全局服务端/客户端时区配置，也允许单个编辑器独立设置时区，从而满足“统一存储、多端本地化显示”与“特定字段固定时区”的混合业务需求。
jvx 提供细粒度的时区控制能力，既支持全局服务端/客户端时区配置，也允许单个编辑器独立设置时区，从而满足“统一存储、多端本地化显示”与“特定字段固定时区”的混合业务需求。
在 JVx 应用中，时区处理并非单一配置项，而是分层设计的体系：服务端、客户端及 UI 组件三个层级均可独立控制，确保灵活性与一致性并存。
1. 服务端时区：决定数据持久化基准
JVx 服务端默认使用 JVM 的 TimeZone.getDefault()，即启动时由 -Duser.timezone 指定（如 java -Duser.timezone=UTC），或继承操作系统时区。该时区直接影响 Date 类型字段写入数据库的时间语义——所有 java.util.Date 值均以该时区为参考进行序列化与存储。因此，强烈建议将服务端时区统一设为 UTC，避免因服务器地域差异导致时间逻辑混乱。
2. 客户端时区：影响默认展示与用户交互
JVx 客户端（Web 或 Mobile）默认自动读取浏览器/设备本地时区，并以此渲染日期时间。若需覆盖此行为（例如强制所有前端按管理员所在时区显示），可通过两种方式配置：
- 在 application.xml 中添加 <parameter name="timezone" value="Asia/Shanghai"/>；
- 或在自定义 Application 子类中调用 setTimeZoneId("Europe/Berlin") 动态设定。
⚠️ 注意：若客户端显式设置了时区，且该时区与服务端一致，则用户看到的时间将与数据库原始值完全相同（即“无转换显示”），适用于审计日志、系统时间戳等需严格对齐的场景。
3. 组件级时区：实现同一数据的多时区并行呈现
这是解决“部分字段需本地化、部分需固定时区”需求的关键。JVx 允许为每个 UIEditor 或 UIDateCellEditor 单独绑定时区，互不干扰。以下示例展示了如何在同一数据行中，让同一列 DATE_COLUMN_NAME 同时以 UTC 和 CET（中欧时间）呈现并可编辑：
// 创建 UTC 时区编辑器
UIDateCellEditor dceUtc = new UIDateCellEditor(DateUtil.getDefaultDateTimeShortPattern());
dceUtc.setTimeZone(TimeZone.getTimeZone("UTC"));
// 创建 CET 时区编辑器
UIDateCellEditor dceCet = new UIDateCellEditor(DateUtil.getDefaultDateTimeShortPattern());
dceCet.setTimeZone(TimeZone.getTimeZone("Europe/Berlin")); // 推荐使用 IANA 标准 ID，而非缩写 CET
// 绑定至不同 UIEditor 实例
UIEditor editorUtc = new UIEditor();
editorUtc.setDataRow(mdbDateTest);
editorUtc.setColumnName("DATE_COLUMN_NAME");
editorUtc.setCellEditor(dceUtc);
UIEditor editorCet = new UIEditor();
editorCet.setDataRow(mdbDateTest);
editorCet.setColumnName("DATE_COLUMN_NAME");
editorCet.setCellEditor(dceCet);✅ 最佳实践提示：
- 始终优先使用 IANA 时区 ID（如 "America/New_York"、"Asia/Tokyo"），避免使用易歧义的缩写（如 "EST"、"CET"）；
- 对于管理后台中的筛选控件（如日期范围选择器），应明确为其编辑器指定业务所需的时区（如 "UTC"），确保跨时区查询逻辑一致；
- 若启用客户端时区自动检测，请在首次加载时通过 getClientTimeZone() 验证实际生效值，便于调试；
- 所有 TimeZone 设置均在线程安全范围内生效，无需额外同步。
通过上述三层协同，JVx 能够精准支撑全球化应用中复杂的时间语义需求：后端统一以 UTC 持久化，前端按需本地化，关键字段按业务规则锁定时区——真正实现“一数多面，各取所需”。
