时间戳转日期

📖 节点概述

将 Unix 时间戳（秒）转换为指定格式的日期时间字符串。支持自定义输出格式（如 %Y-%m-%d %H:%M:%S），转换后的时间为本地时间（根据系统时区）。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 日志时间展示：将日志中的时间戳转换为可读的日期格式。
• 数据导出：将存储的时间戳字段转换为用户友好的日期字符串。
• API 响应处理：将后端返回的时间戳转为前端需要的日期格式。
• 报表生成：将时间戳数据转换为符合报表要求的日期显示格式。
• 调试输出：将计算出的时间戳转为易于理解的时间字符串。

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

节点有两个输入端口：时间戳(秒)（数值）和 输出格式（格式字符串），输出端口 日期字符串。

场景案例：将时间戳 1700000000 转换为默认格式

1. 输入时间戳：在“时间戳(秒)”框中填写 1700000000。
2. 输出格式：使用默认值 %Y-%m-%d %H:%M:%S。
3. 获取结果：日期字符串 输出 "2023-11-14 22:13:20"（取决于时区）。
4. 后续使用：将该字符串用于显示或写入文件。

自定义格式示例：

• 时间戳：1700000000
• 输出格式：%Y年%m月%d日
• 结果："2023年11月14日"

仅日期：

• 输出格式：%Y-%m-%d → "2023-11-14"

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 转换规则

• 使用 datetime.fromtimestamp(ts) 将时间戳转换为本地时间的 datetime 对象。
• 然后通过 strftime(fmt) 格式化为字符串。
• 如果 ts 无效（不是数字或超出范围），返回 "无效时间戳"。
• 如果 fmt 无效（不是合法格式），也可能返回 "无效时间戳"。

⚠️ 注意事项

• 时区：转换结果基于系统本地时区，与当前环境设置有关。不同机器可能产生不同时间字符串。
• 时间戳范围：Unix 时间戳通常表示 1970-01-01 到 2038-01-19 之间的秒数（32 位系统限制）。
• 格式字符串：必须符合 Python strftime 和 strptime 行为，常见格式：
  • %Y：四位年份
  • %m：月份（01-12）
  • %d：日（01-31）
  • %H：小时（00-23）
  • %M：分钟（00-59）
  • %S：秒（00-59）
• 错误处理：无效输入不会中断流程，返回字符串 "无效时间戳"。
• 性能：转换操作极快，适合高频调用。

💎 小贴士：

• 该节点与【日期转时间戳】节点互为逆操作。
• 若需要毫秒级时间戳转换，可先将毫秒值除以 1000 后再输入。
• 使用 %Z 可以输出时区名称，%z 输出时区偏移。
• 由于是纯数据节点，无需执行信号，可在数据流中直接使用。