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

获取当前时间
📖 节点概述
获取当前的系统时间,同时输出两种形式:根据指定格式生成的字符串,以及 Unix 时间戳(秒)。格式参数为 Python strftime 格式字符串,默认 %Y-%m-%d %H:%M:%S(如 2025-01-15 14:30:00)。时间戳为浮点数,精确到微秒。该节点为纯数据节点,无执行端口。
💡 使用场景:
- 记录操作时间:在流程执行时记录开始/结束时间,便于审计或性能分析。
- 生成时间戳文件名:使用当前时间字符串作为文件名(如
2025-01-15.log)。 - 定时触发判断:获取当前时间戳与配置的触发时间比较,决定是否执行任务。
- 时间差计算:在流程开始和结束时分别获取时间戳,计算执行耗时。
- 日志输出:在日志消息中嵌入当前时间信息。
🎮 实战连线指南:如何正确使用它?
节点有一个输入端口 格式(字符串),两个输出端口:时间字符串 和 时间戳(秒)。
场景案例:获取当前时间的默认格式字符串和时间戳
- 格式:留空(使用默认
%Y-%m-%d %H:%M:%S)或手动填写。 - 获取结果:
时间字符串输出如"2025-01-15 14:30:00"。时间戳(秒)输出如1736933400.123456(浮点数)。
- 后续使用:将时间字符串用于显示或文件名,时间戳用于计算间隔。
自定义格式示例:
- 格式:
%Y年%m月%d日 - 结果:
"2025年01月15日"
仅使用时间戳:若不需要时间字符串,可忽略对应端口;反之亦然。
⚙️ 引脚与参数说明
📥 输入引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| 格式 | STRING | 时间格式化字符串(Pythonstrftime 格式)。默认为 %Y-%m-%d %H:%M:%S。 |
⚙️ 控件参数
| 控件名称 | 类型 | 说明 |
|---|---|---|
| 格式 | 单行文本框 | 手动输入格式。连线时优先使用连线值。 |
📤 输出引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| 时间字符串 | STRING | 当前时间的格式化字符串。 |
| 时间戳(秒) | FLOAT | 当前时间的 Unix 时间戳(自 1970-01-01 00:00:00 UTC 起的秒数,包含小数部分)。 |
🔧 时间获取规则
- 使用
datetime.now()获取当前本地时间(系统时区)。 - 根据
格式参数调用strftime生成字符串。 - 调用
timestamp()方法获取浮点数秒数(精确到微秒,实际精度取决于操作系统)。 - 如果
格式参数为空或无效,仍会使用默认格式生成字符串。
⚠️ 注意事项
- 时区:时间戳始终基于 UTC,而时间字符串为本地时间(受系统时区影响)。两者可能不是严格的对应关系,但时间戳与本地时间字符串之间可通过转换库对齐。
- 性能:获取当前时间很快,适合高频调用。
- 格式可用性:若提供了非法的格式字符串,
strftime会抛出异常,节点未做特殊处理,将导致流程错误。建议使用标准格式符号。 - 输出类型:时间戳为浮点数,可用于数值比较或数学运算。
💎 小贴士:
- 如果需要同时获得字符串和时间戳,使用本节点一次即可,避免两次调用。
- 常见格式示例:
%Y-%m-%d(日期)、%H:%M:%S(时间)、%Y%m%d_%H%M%S(紧凑时间戳)。- 可将时间字符串直接用于【变量设置】节点保存,用于后续日志或文件命名。
- 由于是纯数据节点,无需执行信号,可在数据流中直接使用。
这篇文档对您有帮助吗?
您的反馈将帮助我们持续优化文档内容

