Files
marqdo/lib/time.mq.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- 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。
2026-11-18 10:29:26 +08:00

106 lines
2.9 KiB
Markdown
Executable File

---
markup: occlusion
title: lib/time
description: English time wrappers
---
Unix time, format, parse, and sleep helpers.
Format Unix time and control elapsed waits.
Behavior and limits: now reads the clock; sleep controls execution and is clamped in capture. Calendar arithmetic and IANA rules live in datetime.
This single source file is the usage and development manual. Import it directly, or use marqdo call with a function heading below. Parameter tables give types and defaults; required parameters must be supplied. Return tables are progressive contracts; prose describes failure and limits.
Implementation: [src/host/time.rs](../src/host/time.rs)
For development, keep EN/ZH behavior aligned and compose public libraries first. Add host primitives only at OS or algorithm boundaries and declare their effects. Run marqdo check --narrative-ratio on this file and the real workflows in tests/stdlib_tasks.rs after edits.
## now_unix
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | Current Unix time in seconds |
Effects: time.read.
Current Unix time in seconds.
Caller: [time.now_unix]
Return *[Current Unix time in seconds](host_now_unix())*.
## now_ms
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | Current Unix time in milliseconds |
Effects: time.read.
Current Unix time in milliseconds.
Return *[Current Unix time in milliseconds](host_now_ms())*.
## format
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| unix | number | required | Unix timestamp in seconds |
| pattern | text | required | strftime date/time format string |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | Format unix seconds with pattern |
Use `unix`, `pattern` as the inputs for this operation.
Effects: pure.
Call this function directly:
```sh
marqdo call lib/time.mq.md format unix=0 'pattern="%Y-%m-%d"' --effects none --json
```
Format unix seconds with pattern.
Return *[Format unix seconds with pattern](> host_format_time unix=`unix` pattern=`pattern`)*.
## sleep_ms
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| ms | any | required | Duration or delay in milliseconds |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Sleep for ms milliseconds |
Use `ms` as the inputs for this operation.
Effects: process.control.
Sleep for ms milliseconds.
Return *[Sleep for ms milliseconds](> host_sleep_ms ms=`ms`)*.
## parse
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| text | text | required | Text supplied by the caller |
| pattern | text | required | strftime date/time format string |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | Parse text as time with pattern; returns unix seconds |
Use `text`, `pattern` as the inputs for this operation.
Effects: pure.
Parse text as time with pattern; returns unix seconds.
Return *[Parse text as time with pattern; returns unix seconds](> host_parse_time text=`text` pattern=`pattern`)*.