SuperAPI AI 工具集

time-zone-safety

通用与其它

查看项目

更新于 10-16 06:12

技能介绍

用途:统一服务端代码中的时间处理,避免 Docker 镜像默认 UTC 与生产机 Asia/Shanghai 不一致导致“本周起点”等统计偏差。触发信号包括 LocalDate.now()/LocalDateTime.now()/Instant.now()/new Date()/Date.now()/time.Now(),以及周月日起点、跨时区比较和数据库时间字段。

主要能力:以四类陷阱组织规范。一,裸调 .now() 依赖 JVM 默认时区,须用项目常量 BIZ_ZONE(如 ZoneId.of("Asia/Shanghai"))显式传入;Instant.now() 无歧义可裸用。二,周/月/日起点计算缺失时区,须在 with(DayOfWeek.MONDAY).atStartOfDay() 链路前带 BIZ_ZONE;若 DB 存 UTC 需先转 Instant。三,数据库与应用层时区不一致,给出策略 A(DATETIME + serverTimezone=Asia/Shanghai + LocalDateTime)与策略 B(TIMESTAMP + serverTimezone=UTC + Instant/OffsetDateTime),禁止混用,并建议 Dockerfile 固定 ENV TZ。四,跨时区比较,用户时间字符串须定义时区语义,比较统一转 Instant,日志带时区。附 Go、Python、Node.js/TypeScript 多语言示例,以及应用层、数据层、部署层、接口层总检查清单。

使用方式:将技能作为编码规范用于 review,配合 grep 嗅探裸 now 调用。

适用场景:中国单时区业务与跨时区 SaaS 均可,但需先选定策略并文档化。限制:资料未提供具体价格、平台支持或集成安装方式。