日期转时间戳

📖 节点概述

将日期时间字符串转换为 Unix 时间戳。支持自定义日期格式（如 %Y-%m-%d %H:%M:%S），输入留空时自动使用当前时间。输出单位可选秒（整数）或毫秒（浮点数）。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 日志时间解析：将日志文件中的时间字符串转换为时间戳，便于排序或计算间隔。
• 数据迁移：将旧系统中的日期字符串转换为统一的时间戳格式存储。
• API 参数处理：接收客户端传来的日期字符串，转为时间戳后再进行业务逻辑处理。
• 时间比较：将日期转为时间戳后，可以直接进行数值比较。
• 定时任务：将用户配置的日期时间字符串转为时间戳，用于判断任务是否到达执行时间。

🎮 实战连线指南：如何正确使用它？

节点有两个主要输入端口：日期时间（字符串）和 日期格式（格式字符串），以及一个单位下拉选择。输出端口 时间戳。

场景案例：将 "2025-01-01 12:00:00" 转换为秒级时间戳

1. 填写日期时间：2025-01-01 12:00:00
2. 填写日期格式：%Y-%m-%d %H:%M:%S（默认）
3. 单位选择：秒
4. 获取结果：输出类似 1735704000 的整数。
5. 后续使用：将该时间戳用于计时或存储。

自定义格式示例：

• 日期时间：01/01/2025 12:00
• 日期格式：%m/%d/%Y %H:%M
• 输出结果同上述示例。

留空日期时间：

• 不填写“日期时间”（或连线传入空字符串），则使用当前时间。
• 例如输出当前时刻的 Unix 时间戳。

毫秒单位：

• 选择单位 毫秒，输出浮点数，如 1735704000.000（毫秒精度）。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 转换规则

• 如果“日期时间”不为空，使用 datetime.strptime(dt_str, fmt_str) 解析。
• 如果解析成功，调用 datetime.timestamp() 获取浮点秒数。
• 如果解析失败，返回 0（秒模式）或 0.0（毫秒模式）。
• 如果“日期时间”为空（或空白字符串），使用 datetime.now().timestamp() 获取当前时间戳。
• 秒模式：将秒数取整 int(ts)。
• 毫秒模式：将秒数乘以 1000（返回浮点数，保留毫秒精度）。

⚠️ 注意事项

• 格式字符串：必须与输入日期时间字符串完全匹配，否则解析失败。常见的格式：
  • %Y：四位年份
  • %m：月份（01-12）
  • %d：日（01-31）
  • %H：小时（00-23）
  • %M：分钟（00-59）
  • %S：秒（00-59）
• 时区：解析的日期时间视为本地时间（无时区），转换后的时间戳为 UTC 时间戳。
• 当前时间：当“日期时间”留空时，使用系统当前时间（含时区）。
• 错误处理：解析失败不会导致流程中断，返回 0 或 0.0。
• 输出类型动态变化：根据“单位”选择，输出端口的类型会动态切换（INT / FLOAT）。

💎 小贴士：

• 该节点与【时间戳转日期】节点互为逆操作。
• 如果需要处理毫秒级时间戳（13 位整数），本节点生成的毫秒单位输出为浮点数，可以再使用【转为整数】节点得到整数毫秒值。
• 常用的日期格式可查阅 Python strptime 文档。
• 由于是纯数据节点，无需执行信号，可在数据流中直接使用。