极奇策RPA技术教程:当前时间戳 (NodeCurrentTimestamp) - 自动化开发与配置详细指南

当前时间戳
📖 节点概述
获取当前的 Unix 时间戳。支持两种单位:秒(整数)或毫秒(浮点数,精度为毫秒)。该节点为纯数据节点,无执行端口。
💡 使用场景:
- 记录事件时间:在流程中记录关键操作的触发时间。
- 计算耗时:在执行开始和结束时分别获取时间戳,计算差值得到耗时。
- 生成唯一 ID:将时间戳作为唯一标识符的一部分(配合随机数)。
- 超时判断:在循环或等待节点中,结合当前时间戳判断是否超时。
- 日志时间戳:为日志输出添加当前时间信息。
🎮 实战连线指南:如何正确使用它?
节点有一个下拉选择“单位”,输出端口 时间戳(类型根据单位动态变化)。
场景案例:获取当前秒级时间戳
- 单位选择:下拉框选择
秒。 - 获取结果:
时间戳输出类似1700000000的整数(秒)。 - 后续使用:将该值存储到变量中,或用于时间比较。
毫秒级示例:
- 单位选择
毫秒→ 输出浮点数如1700000000.123(毫秒精度)。
⚙️ 引脚与参数说明
📥 输入引脚
无数据输入端口。
⚙️ 控件参数
| 控件名称 | 类型 | 说明 |
|---|---|---|
| 单位 | 下拉选择 | •秒:输出整数秒(Unix 时间戳,从 1970-01-01 00:00:00 UTC 起经过的秒数)。<br>• 毫秒:输出浮点数,包含毫秒部分(如 1700000000.123)。 |
📤 输出引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| 时间戳 | INT 或 FLOAT | 根据单位选择,秒为单位时返回整数,毫秒为单位时返回浮点数。 |
🔧 生成规则
- 使用 Python 标准库
time.time()获取当前时间戳(自纪元以来的浮点数秒数)。 - 秒模式:直接取整
int(ts)。 - 毫秒模式:返回原始浮点数(保留小数,实际精度取决于系统,通常为微秒级)。
⚠️ 注意事项
- 时区:Unix 时间戳始终基于 UTC,不受本地时区影响。
- 精度:毫秒模式下,实际精度可能因操作系统而异,但通常能达到毫秒级。
- 性能:获取时间戳非常快,适合高频调用。
- 输出类型动态变化:根据“单位”选择,输出端口的类型和颜色会在 INT 和 FLOAT 之间切换,下游节点应能适配。
💎 小贴士:
- 秒模式输出整数,适合用于需要整数的场景(如数据库整数字段)。
- 毫秒模式保留小数,可用于高精度计时或与 JavaScript 的
Date.now()兼容。- 可与【变量设置】节点配合,将时间戳保存为变量供后续使用。
- 由于是纯数据节点,无需执行信号,可在数据流中直接使用。
这篇文档对您有帮助吗?
您的反馈将帮助我们持续优化文档内容

