豫言 / 豫言操作系统时间 @ 0.2.0

读取同一时点的 UTC 日期与 Unix 分钟,并读取 Unix 毫秒及转换 ISO 文字。

源码浏览已生成;不能解析的文件以纯文本展示,不表示通过类型检查。

规范.汉语.md

# 时间接口规范 0.2.0

`读取当前UTC日与Unix分钟` 从同一个墙上时钟采样返回两项:按 UTC 计算的 `YYYY-MM-DD` 日期,以及自 1970-01-01T00:00:00Z 起向下取整的分钟数。两项必须由同一个瞬间计算,避免跨日或跨分钟时出现不一致。此时间可用于每日和每分钟额度规则,不承诺单调性;测量耗时应使用基础包的单调时钟。宿主时钟不可用时调用失败。

`读取当前Unix毫秒` 返回墙上时钟自 1970-01-01T00:00:00Z 起的毫秒数,用整数表示,不承诺单调;同一请求内多次调用可以得到不同值,需要一致时刻的计算应只读取一次。`Unix毫秒转ISO文字` 把毫秒写成 `YYYY-MM-DDTHH:mm:ss.sssZ` 的 UTC 文字(与 ECMAScript `Date.prototype.toISOString` 一致);毫秒的绝对值超过 8640000000000000 时调用失败。星期、小时和自定义日期格式不在本包内,应用可用毫秒整数自行运算(1970-01-01 是星期四)。

规范.文言.md

# 时间之约 0.2.0

`读取当前UTC日与Unix分钟` 取墙上钟之一瞬,返 UTC `YYYY-MM-DD` 之日与自 1970-01-01T00:00:00Z 起下取整之分钟数。二值必出同一瞬,毋使跨日跨分而相左。可据之定每日、每分之额;不保单调,计历时当用基础包单调钟。宿主钟不可得则败。

`读取当前Unix毫秒` 返墙上钟自 1970-01-01T00:00:00Z 起之毫秒,以整数表之,不保单调;同请求内屡取可异,需同刻之算,当仅取一次。`Unix毫秒转ISO文字` 书毫秒为 `YYYY-MM-DDTHH:mm:ss.sssZ` 之 UTC 文(同 ECMAScript `Date.prototype.toISOString`);毫秒绝对值逾 8640000000000000 则败。星期、时辰与他式日期不在此包,客自以毫秒整数算之(1970-01-01 乃星期四)。