Initial Dever 0.0.1

lib/doc/dever-time-operations.md

@@ -0,0 +1,47 @@
+# 日期与时长
+
+使用 UTC 日期时间和毫秒时长。
+
+## dever.time.now
+
+读取当前 UTC 日期时间，精度为毫秒。
+
+## dever.time.parseDatetime
+
+解析 RFC3339 和明确偏移，最多三位小数；拒绝闰秒及转换后超出四位 UTC 年份的值。
+
+## dever.time.formatDatetime
+
+输出 UTC YYYY-MM-DDTHH:MM:SS[.sss]Z；零毫秒省略小数。
+
+## dever.time.parseDate
+
+解析严格的 YYYY-MM-DD，验证实际日历日期。
+
+## dever.time.formatDate
+
+输出 YYYY-MM-DD，Date 表示 UTC 午夜毫秒。
+
+## dever.time.parseTime
+
+解析 HH:MM:SS 或 HH:MM:SS.sss；拒绝闰秒和无效钟点。
+
+## dever.time.formatTime
+
+输出 HH:MM:SS[.sss]，零毫秒省略小数。
+
+## dever.time.duration
+
+构造有符号毫秒时长，保留完整 Int 范围。
+
+## dever.time.add
+
+相加并检查 i64 溢出；结果是否能格式化由格式化操作判断。
+
+## dever.time.subtract
+
+相减并检查 i64 溢出；结果是否能格式化由格式化操作判断。
+
+## dever.time.difference
+
+计算有符号毫秒差，溢出时传播 DurationResult.Failed。