日期和时间
本页收录标准函数分类“日期和时间”下的完整 API 合同。
合并日期与日内时间
CONCAT_DATE_TOD
可执行
标准函数 CONCAT_DATE_TOD:把 DATE 和 TOD 合并为 DT Unix 微秒时间戳。
声明层
已声明验证层
已验证执行层
可执行
签名
DT CONCAT_DATE_TOD(DATE date, TOD tod)
参数
dateDATE- 天数(自 1970-01-01)。
todTOD- 当日毫秒数。
返回值
returnDT- 合并后的 Unix 微秒时间戳。
行为说明
- DATE 天数 + TOD 毫秒 → 微秒时间戳。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
合并日期和日内时间。
DT ts = CONCAT_DATE_TOD(today, nowMs);
相关 API
暂无已核实关系。
提取星期
DAY_OF_WEEK
可执行
标准函数 DAY_OF_WEEK:从 DT Unix 微秒时间戳提取星期编号。
声明层
已声明验证层
已验证执行层
可执行
签名
INT DAY_OF_WEEK(LINT timestamp)
参数
timestampLINT- Unix 微秒 DT 时间戳。
返回值
returnINT- 星期编号。
行为说明
- 从时间戳提取星期。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
提取星期编号。
INT weekday = DAY_OF_WEEK(timestampUs);
相关 API
暂无已核实关系。
日期时间加时长
DT_ADD
可执行
标准函数 DT_ADD:给 DT 时间戳增加指定时长(毫秒)。
声明层
已声明验证层
已验证执行层
可执行
签名
DT DT_ADD(DT dt, TIME durationMs)
参数
dtDT- Unix 微秒时间戳。
durationMsTIME- 要增加的毫秒数。
返回值
returnDT- 增加时长后的新时间戳。
行为说明
- dt_us + duration_ms * 1000 → 新微秒时间戳。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
当前时间加 5 秒。
DT later = DT_ADD(now, 5000);
相关 API
暂无已核实关系。
比较日期时间
DT_CMP
可执行
标准函数 DT_CMP:三向比较两个 DT 时间戳。
声明层
已声明验证层
已验证执行层
可执行
签名
INT DT_CMP(DT dt1, DT dt2)
参数
dt1DT- 第一个时间戳。
dt2DT- 第二个时间戳。
返回值
returnINT- dt1 < dt2 返回 -1;相等返回 0;dt1 > dt2 返回 1。
行为说明
- 三向序比较:-1/0/1。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
比较两个时间戳的先后顺序。
INT order = DT_CMP(t1, t2);
相关 API
暂无已核实关系。
提取日期
DT_DAY
可执行
标准函数 DT_DAY:从 DT Unix 微秒时间戳提取日期(月内日)。
声明层
已声明验证层
已验证执行层
可执行
签名
INT DT_DAY(DT dt)
参数
dtDT- Unix 微秒时间戳。
返回值
returnINT- 月内日(1-31)。
行为说明
- 确定性 UTC 历法分解。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
提取当前时间的日期。
INT d = DT_DAY(now);
相关 API
暂无已核实关系。
提取小时
DT_HOUR
可执行
标准函数 DT_HOUR:从 DT Unix 微秒时间戳提取小时。
声明层
已声明验证层
已验证执行层
可执行
签名
INT DT_HOUR(DT dt)
参数
dtDT- Unix 微秒时间戳。
返回值
returnINT- 小时(0-23)。
行为说明
- 确定性 UTC 历法分解。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
提取当前时间的小时。
INT h = DT_HOUR(now);
相关 API
暂无已核实关系。
提取分钟
DT_MINUTE
可执行
标准函数 DT_MINUTE:从 DT Unix 微秒时间戳提取分钟。
声明层
已声明验证层
已验证执行层
可执行
签名
INT DT_MINUTE(DT dt)
参数
dtDT- Unix 微秒时间戳。
返回值
returnINT- 分钟(0-59)。
行为说明
- 确定性 UTC 历法分解。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
提取当前时间的分钟。
INT m = DT_MINUTE(now);
相关 API
暂无已核实关系。
提取月份
DT_MONTH
可执行
标准函数 DT_MONTH:从 DT Unix 微秒时间戳提取月份。
声明层
已声明验证层
已验证执行层
可执行
签名
INT DT_MONTH(DT dt)
参数
dtDT- Unix 微秒时间戳。
返回值
returnINT- 月份(1-12)。
行为说明
- 确定性 UTC 历法分解。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
提取当前时间的月份。
INT mon = DT_MONTH(now);
相关 API
暂无已核实关系。
提取秒
DT_SECOND
可执行
标准函数 DT_SECOND:从 DT Unix 微秒时间戳提取秒。
声明层
已声明验证层
已验证执行层
可执行
签名
INT DT_SECOND(DT dt)
参数
dtDT- Unix 微秒时间戳。
返回值
returnINT- 秒(0-59)。
行为说明
- 确定性 UTC 历法分解。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
提取当前时间的秒。
INT s = DT_SECOND(now);
相关 API
暂无已核实关系。
日期时间相减
DT_SUB
可执行
标准函数 DT_SUB:计算两个 DT 时间戳之间的毫秒差。
声明层
已声明验证层
已验证执行层
可执行
签名
TIME DT_SUB(DT dt1, DT dt2)
参数
dt1DT- 第一个时间戳(被减数)。
dt2DT- 第二个时间戳(减数)。
返回值
returnTIME- 毫秒差。
行为说明
- (dt1_us - dt2_us) / 1000 → 毫秒差值。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
计算经过的毫秒数。
TIME elapsed = DT_SUB(end, start);
相关 API
暂无已核实关系。
日期时间转日期
DT_TO_DATE
可执行
标准函数 DT_TO_DATE:从 DT Unix 微秒时间戳提取 DATE 天数。
声明层
已声明验证层
已验证执行层
可执行
签名
DATE DT_TO_DATE(DT dt)
参数
dtDT- Unix 微秒时间戳。
返回值
returnDATE- 自 1970-01-01 以来的天数。
行为说明
- 确定性 UTC 历法分解,提取日期部分。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
提取当前时间的日期部分。
DATE d = DT_TO_DATE(now);
相关 API
暂无已核实关系。
日期时间转日内时间
DT_TO_TOD
可执行
标准函数 DT_TO_TOD:从 DT Unix 微秒时间戳提取 TOD 当日毫秒。
声明层
已声明验证层
已验证执行层
可执行
签名
TOD DT_TO_TOD(DT dt)
参数
dtDT- Unix 微秒时间戳。
返回值
returnTOD- 当日毫秒数。
行为说明
- 确定性 UTC 历法分解,提取日内时间部分。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
提取当前时间的日内时间。
TOD t = DT_TO_TOD(now);
相关 API
暂无已核实关系。
提取年份
DT_YEAR
可执行
标准函数 DT_YEAR:从 DT Unix 微秒时间戳提取年份。
声明层
已声明验证层
已验证执行层
可执行
签名
INT DT_YEAR(LINT timestamp)
参数
timestampLINT- Unix 微秒 DT 时间戳。
返回值
returnINT- 公历年份。
行为说明
- 从时间戳提取年份。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
读取当前年份。
INT year = DT_YEAR(RTC());
相关 API
暂无已核实关系。
整数转时间
INT_TO_TIME
可执行
标准函数 INT_TO_TIME:把 INT 毫秒值转换为 TIME。
声明层
已声明验证层
已验证执行层
可执行
签名
TIME INT_TO_TIME(INT value)
参数
valueINT- INT 毫秒值。
返回值
returnTIME- 恒等转换结果。
行为说明
- TIME 与 INT 都按毫秒计,数值保持。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
把 INT 毫秒值转换为 TIME。
TIME duration = INT_TO_TIME(ms);
相关 API
暂无已核实关系。
读取实时时钟
RTC
可执行
标准函数 RTC:读取当前 Unix 微秒墙钟时间戳。
声明层
已声明验证层
已验证执行层
可执行
签名
LINT RTC()
参数
无参数。
返回值
returnLINT- 当前 Unix 微秒墙钟时间戳。
行为说明
- 返回真实墙钟时间,不是扫描周期相对时间。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
读取当前 Unix 微秒时间戳。
LINT timestampUs = RTC();
相关 API
暂无已核实关系。
时间转整数毫秒
TIME_TO_INT
可执行
标准函数 TIME_TO_INT:把 TIME 毫秒值转换为 INT 数值路径。
声明层
已声明验证层
已验证执行层
可执行
签名
INT TIME_TO_INT(TIME duration)
参数
durationTIME- TIME 毫秒值。
返回值
returnINT- 毫秒整数值。
行为说明
- 转换保持毫秒数值。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
读取 TIME 的毫秒数。
INT elapsedMs = TIME_TO_INT(elapsed);
相关 API
暂无已核实关系。
共享错误码
以下错误码在本分类的多个 API 条目中重复出现,统一在此说明以避免冗余。各条目的"错误与限制"小节仅列出该 API 专属的错误码。
错误码前缀对照
| 前缀 | 含义 | 示例 |
|---|---|---|
COMPILE_ | 编译参数:SCL 参数类型/范围/枚举校验 | COMPILE_ARGUMENT_ERROR |
COMPILE_ARGUMENT_ERROR
COMPILE_ 编译参数:SCL 参数类型/范围/枚举校验
出现在 16 个 API 条目中。
- 缺少必需实参或参数类型不匹配时编译失败。