- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
41 lines
1.1 KiB
Markdown
Executable File
41 lines
1.1 KiB
Markdown
Executable File
# 设计:`lib/datetime` / `lib/日期时间`(Mid2 M7)
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | **已落地** |
|
||
| 日期 | 2026-09-09 |
|
||
| 父设计 | [stdlib-mid2.md](stdlib-mid2.md) §2.1 |
|
||
| 宿主 | `src/host/datetime.rs` · `host_datetime_*` |
|
||
|
||
---
|
||
|
||
## 1. 时刻形状
|
||
|
||
每次返回 **map**:
|
||
|
||
| 键 | 含义 |
|
||
|----|------|
|
||
| `unix` | 秒级 Unix 戳(int) |
|
||
| `zone` | 固定偏移文本,如 `+08:00` / `+00:00` |
|
||
| `iso` | RFC3339(秒精度) |
|
||
|
||
`to_unix` 也接受裸 int 或 ISO 文本。
|
||
|
||
## 2. API
|
||
|
||
| EN | ZH | 说明 |
|
||
|----|-----|------|
|
||
| `now` | `现在` | UTC 此刻(wasm 无时钟桥则失败) |
|
||
| `from_unix` | `自戳` | `unix` + 可选 `zone` |
|
||
| `to_unix` | `成戳` | |
|
||
| `parse` | `解析` | 默认 RFC3339 / `YYYY-MM-DD[ HH:MM:SS]`;`pattern=` |
|
||
| `format` | `格式化` | `rfc3339`/`date`/`time` 或 strftime |
|
||
| `add` | `加` | `days`/`hours`/`minutes`/`seconds` |
|
||
| `in_zone` | `时区` | 同瞬间换区 |
|
||
|
||
**区名**:`+HH:MM` / `UTC` / `Z`,以及少量固定偏移别名(如 `Asia/Shanghai`)。**不做**完整 tzdb / DST。
|
||
|
||
## 3. 与 `lib/time`
|
||
|
||
`lib/time` 保留极简 unix/format/parse/sleep。日历语义用本库。
|