用途:在智能体创建、修改或审查代码时,确保日期、时间、日期时间和相关值使用与真实语义相符的内置或标准库时间类型,而不是通用字符串、数字或松散对象。
主要能力:按值含义选择最精确的内置时间类型——仅有日历日期用日期类型,仅有墙上时间用时间类型,同时含日期与时间用日期时间类型;当时区语义重要时,使用能携带地理时区的表示,优先采用含真实时区规则的 IANA 时区 ID,而非固定偏移。若栈将时刻与时区标识分离,需同时显式保留两者,偏移只作为边界细节。
适用范围:定义日期、时间、日期时间、时间戳、日程、截止时间或重复字段;定义时间参数或返回类型;解析或序列化时间值;映射到持久化或传输边界;计算或比较时间值;存储或暴露时区信息;建模依赖日历或时钟语义的业务与集成概念。
使用方式:先判断真实时间含义(日历日期、墙上时间、日期时间、时刻、日程或时区感知时间戳),再检查栈中可用的原生或标准库时间类型,并遵循项目既有导入、构造、存储与序列化约定。尽早把外部字符串解析为内置时间类型,仅在边界序列化回外部格式;需要保持时区感知时保留地理时区标识,并验证夏令时变化后本地时间、日程与截止时间仍能正确解析。
限制:该技能依赖语言或标准库本身是否提供相应时间类型及时区表示;若栈不支持单一内置时区类型,需将内置时间值与地理时区标识配合保存。资料未提供具体语言示例、命令或代码规范细节,使用时需结合项目实际情况。