Files
marqdo/lib/time.mq.md

2.9 KiB

markup, title, description
markup title description
occlusion lib/time 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

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.

now_ms

返回 类型 说明
result number Current Unix time in milliseconds

Effects: time.read.

Current Unix time in milliseconds.

Return Current Unix time in milliseconds.

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:

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).