金额和时间字段的类型约定
收录 2026-10
金额用浮点、时间用本地格式，跨端解析各出各的错，统一定义字段类型
接口里的 [字段名] 等金额与时间字段在各处写法不一，有浮点、有字符串、有本地时间格式。请定一套约定：金额用什么类型和单位、时间用什么格式和时区、空值怎么表示，并说明各语言解析时的注意事项。输出：字段类型规范、现有接口的整改清单、以及序列化与反序列化的示例。
本站原创
中文原文
使用示例
示例输入
接口里金额和时间的写法不一，有浮点有字符串有本地格式，定一套统一约定。
输出应包含
- 定金额类型、单位与时间格式时区
- 说明空值表示与各语言解析注意
- 按约定给现有接口整改清单
复制前替换这些占位符 1
把方括号里的内容换成你的具体信息，替换后再粘贴给 AI。
[字段名]
使用建议
金额用最小货币单位的整数或字符串，别指望浮点在跨语言时表现一致。
可以这样改
- 要求它先复述需求与约束，确认无误再写代码。
- 让它给出最小改动 + 回滚方式，而不是整文件重写。
交付物（这次应拿到什么）
- 可运行的最小改动（含直接可用的代码块）
- 影响面清单：改了哪些文件、哪些调用点要跟着改
常见错法
- 一次让它改十个文件，最后分不清哪处改动导致了新问题。
- 只贴报错不贴代码和版本，拿到无法落地的修法。
输出验收（怎么判断能用）
- 改动可运行、可回滚，且没顺手改无关代码。
- 边界条件（空值、超长、并发）有说明或测试。
适用场景与注意
- 适合：让它先复述需求和约束，再给最小可运行改动。
- 注意：贴报错时同时给版本号与最小复现，否则它容易给出看似合理但不适配的写法。