时间格式化

📖 节点概述

将时间字符串按照指定的输入格式解析，再按照指定的输出格式重新格式化。输入时间留空时，使用当前系统时间。常用于不同系统间的时间格式转换、统一时间显示格式等场景。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 格式转换：将 2024-01-01 12:00:00 转为 01/01/2024 12:00 PM 等。
• 标准化输出：将各种输入格式（如 2024/01/01、Jan 1 2024）统一为一种标准格式。
• 当前时间格式化：不提供输入时间，直接获取当前时间的指定格式字符串。
• 日志处理：将日志文件中的非标准时间格式统一为易于排序的格式。
• 数据清洗：在导入数据时，将各种时间表示转换为数据库支持的格式。

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

节点有三个输入端口：输入时间、输入格式、输出格式，输出端口 结果。

场景案例：将 2024-01-01 12:00:00 转换为 01/01/2024

1. 输入时间：2024-01-01 12:00:00
2. 输入格式：%Y-%m-%d %H:%M:%S（默认）
3. 输出格式：%m/%d/%Y
4. 获取结果："01/01/2024"

使用当前时间：

• 留空“输入时间”，其他参数不变，则输出当前时间的默认格式。

自定义输入格式：

• 输入时间：2024年01月01日 12:00
• 输入格式：%Y年%m月%d日 %H:%M
• 输出格式：%Y-%m-%d %H:%M:%S
• 输出："2024-01-01 12:00:00"

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 转换规则

• 如果“输入时间”非空，使用 datetime.strptime(input_time, in_fmt) 解析为 datetime 对象。
• 如果“输入时间”为空或仅包含空白字符，使用 datetime.now() 获取当前时间。
• 然后使用 datetime.strftime(out_fmt) 格式化为输出字符串。
• 若解析或格式化过程出错，返回相应的错误提示字符串。

⚠️ 注意事项

• 格式严格匹配：输入格式必须与输入时间字符串完全一致，否则解析失败。
• 当前时间时区：使用 datetime.now() 获取的是系统本地时间（含时区偏移，但 datetime 对象为 naive），格式化输出时也是本地时间。
• 常见格式符号：
  • %Y：四位年份
  • %m：月份（01-12）
  • %d：日（01-31）
  • %H：小时（00-23）
  • %M：分钟（00-59）
  • %S：秒（00-59）
  • 更多符号参考 Python strftime 文档。
• 错误处理：节点不会抛出异常，而是返回明确的错误信息字符串，下游可根据内容判断。
• 性能：转换操作非常快，适合高频调用。

💎 小贴士：

• 该节点是通用的时间转换工具，可替代“当前时间”+“格式化”两步操作。
• 若只需当前时间的特定格式，可将“输入时间”留空，仅设置“输出格式”。
• 若要转换时间戳为字符串，请使用【时间戳转日期】节点。
• 由于是纯数据节点，无需执行信号，可在数据流中直接使用。