获取时间部件

📖 节点概述

从日期时间字符串中提取指定的时间部件（如年、月、日、时、分、秒、星期等）。输入可以为空（使用当前系统时间），格式必须为 YYYY-MM-DD HH:MM:SS。支持提取年份、月份、日期、小时、分钟、秒、毫秒、微秒、星期几（ISO 标准，周一为 1）、一年中的第几天、ISO 周数、季度、时间戳（秒或毫秒）。输出为整数。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 数据分类：根据日期中的月份或季度对数据进行分组统计。
• 条件判断：判断某一天是否为周末（星期 6 或 7）或特定日期。
• 时区无关的时间比较：通过提取年、月、日等数值进行自定义比较。
• 报表生成：提取时间的年份、季度、周数作为报表维度。
• 时间戳转换：从日期字符串直接获得时间戳（秒/毫秒），便于数学计算。

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

节点有一个输入端口 日期/时间（字符串，格式 YYYY-MM-DD HH:MM:SS）和一个下拉选择“部件”，输出端口 数值（整数）。

场景案例：提取当前时间的年份

1. 日期/时间：留空（使用当前系统时间）。
2. 部件：选择 年。
3. 获取结果：数值 输出当前年份，如 2025。
4. 后续使用：将该年份用于变量存储或条件判断。

提取具体日期部件：

• 输入 2025-01-15 14:30:45
• 部件 月 → 1
• 部件 日 → 15
• 部件 时 (24小时制) → 14
• 部件 分 → 30
• 部件 秒 → 45

提取星期（ISO）：

• 输入 2025-01-15 14:30:45（星期三）→ 星期部件输出 3（周一=1，周日=7）

提取时间戳：

• 部件 时间戳 (秒) → 返回 Unix 时间戳（秒），例如 1736933445。
• 部件 时间戳 (毫秒) → 返回毫秒级时间戳，例如 1736933445000。

一年第几天/第几周：

• 输入 2025-01-15 → 一年第几天：15；一年第几周（ISO）：3。

季度：

• 1~3 月 → 1；4~6 月 → 2；7~9 月 → 3；10~12 月 → 4。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 部件详情

⚠️ 注意事项

• 日期格式固定：输入必须为 YYYY-MM-DD HH:MM:SS，否则解析失败返回 0。
• 时区：解析的字符串视为本地时间，时间戳转换时也会基于本地时间转换为 UTC 时间戳（datetime.timestamp() 行为）。若需要纯 UTC 时间戳，请提前将字符串转为 UTC。
• 当前时间：留空时使用 datetime.now() 获取本地时间。
• 毫秒/微秒：提取毫秒和微秒时，两者是基于时间的子秒部分，不是总毫秒数。例如 0.123456 秒 → 毫秒 123，微秒 123456。
• 星期：使用 ISO 标准，周一为 1，周日为 7。若需传统星期（周日=0 或 1），可自行转换。
• 一年第几周：使用 ISO 周号，周一作为每周首天，第一周包含该年的首个星期四。
• 性能：提取操作很快。

💎 小贴士：

• 若需要提取多个部件，可复制多个节点分别设置，或使用【时间格式化】节点直接输出自定义字符串。
• 时间戳（秒/毫秒）可以直接用于数学运算或与【当前时间戳】节点结果比较。
• 结合【条件判断】节点，可以根据星期判断是否为工作日，根据季度决定报表周期等。
• 由于是纯数据节点，无需执行信号，可在数据流中直接使用。