类对象支持库（不是扁平命令）。路径：支持库 → 扩展类库 → 日期时间类。
类型名必须写完整「日期时间类」。声明时自动创建，一般无需再调 创建*。
硬约束
- 类型名必须写「日期时间类」。
- 解析/加减/格式化；与扁平 日期时间 互补。
- 方法调用必须带括号。
快速开始
日期时间类 t
t.取当前时间()
输出(t.到文本())
t.加(7) // 默认按日；单位：1秒 2分 3时 4日 5月 6年
输出(t.取年())
日期时间类/创建
共 1 条。
创建日期时间
- 签名：
通用 创建日期时间() - 说明：创建可反复操作的日期时间对象。通常直接写「日期时间类 dt」，不必调用本命令。
日期时间类/方法
共 16 条。
解析
- 签名：
逻辑 解析(文本 日期时间文本) - 说明：从文本解析并写入对象；成功返回真。支持 yyyy-MM-dd HH:mm:ss、仅日期、斜杠形式。
- 参数一│文本 日期时间文本: 如 2026-09-02 12:30:00
取当前时间
- 签名：
逻辑 取当前时间() - 说明：把对象设为当前本地日期时间；成功返回真。（与基础库命令「取当前时间()」不同：基础库返回文本，本方法写入对象。）
从时间戳
- 签名：
逻辑 从时间戳(长整数 时间戳, [逻辑 毫秒=假]) - 说明：从 Unix 时间戳填充对象；毫秒=真 时参数为 13 位毫秒戳。
- 参数一│长整数 时间戳
- 参数二│[逻辑 毫秒=假]: 真=单位为毫秒。
加
- 签名：
逻辑 加(长整数 数量, [整数 单位=4]) - 说明：在当前值上加/减时间；数量为负表示减。单位用整数：1=秒 2=分 3=时 4=日（默认） 5=月 6=年。
- 参数一│长整数 数量: 可为负数。
- 参数二│[整数 单位=4]: 可选。1=秒 2=分 3=时 4=日（默认） 5=月 6=年
到文本
- 签名：
文本 到文本([整数 格式=1]) - 说明：格式化为文本。1=yyyy-MM-dd HH:mm:ss（默认），2=仅日期，3=斜杠带时间，4=斜杠仅日期。
- 参数一│[整数 格式=1]: 见 docs/datetime-obj.md。
取时间戳
- 签名：
整数 取时间戳([逻辑 毫秒=假]) - 说明：输出 Unix 时间戳；可选毫秒精度。
- 参数一│[逻辑 毫秒=假]
比较
- 签名：
整数 比较(日期时间类 其他) - 说明：与另一个日期时间对象比较：更早返回负数，相等 0，更晚返回正数。参数必须是日期时间类变量，不能传文本。
- 参数一│日期时间类 其他: 另一个已赋值的对象。
取年
- 签名：
整数 取年() - 说明：取年份。
取月
- 签名：
整数 取月() - 说明：取月份（1–12）。
取日
- 签名：
整数 取日() - 说明：取日（1–31）。
取时
- 签名：
整数 取时() - 说明：取小时（0–23）。
取分
- 签名：
整数 取分() - 说明：取分钟（0–59）。
取秒
- 签名：
整数 取秒() - 说明：取秒（0–59）。
是否有效
- 签名：
逻辑 是否有效() - 说明：当前是否已成功解析或赋值。
清空
- 签名：
无 清空() - 说明：清空当前日期时间。
取错误
- 签名：
文本 取错误() - 说明：取最近一次失败原因。
易错对照
| 错误 | 正确 |
|---|---|
| 类型写成「日期时间」 | 必须「日期时间类」 |
| 单位写文本 | 用整数：1秒 2分 3时 4日 5月 6年 |